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CHAPTER 1 

THE CASSETTE PROGRAMMING SYSTEM 


1.1 INTRODUCTION TO A CASSETTE STORAGE SYSTEM 

The PDP-8 Cassette Programming System (CAPS-8) is a small programming 
system for the PDP-8/E (8/M or 8/F) computer and is designed around 
the use of cassettes for program storage, rather than DECtape, paper 
tape or disk storage, CAPS-8 replaces paper tape procedures 
completely. The MI8-E Hardware Bootstrap initially loads the Cassette 
Keyboard Monitor into memory; with th€J use of the Monitor all file 
transfers and program loading and storage is done via cassette. 
Cassettes are more convenient and reliable' and much easier to use than 
paper tape, and in addition, cut the times involved in loading and 
storing programs using paper tape by almost one half, 

CAPS-8 provides the user with a Keyboard Monitor, I/O facilities at 
the Monitor level, and a library of System Programs, including a 
machine language assembler, an editor, and a higher- level programming 
language . 



Figure 1-1 Cassette Programming System 
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1.1,1 Hardware Components 


The Cassette Programming System is built around a PDP-8/E, 8/M, or 8/F 
computer with a minimum of one TU60 dual cassette unit, a console 
terminal (LA30 DECwriter, LT33 or LT35 Teletype, or VT05 DECterminal) , 
and 8K of memory. A line printer is optional. 


1.1,2 Software Components 

A brief description of the software package available with the 
Cassette Programming System follows. Each program is discussed in 
greater detail later in the manual. 

1. MONITOR -- The Keyboard Monitor provides communication 
between the user and the Cassette System Executive 
Routines by accepting commands from the console terminal 
keyboard. The commands allow the user to run system and 
user programs, save programs on cassette, and obtain 
directories of cassettes, 

2. Symbolic EDITOR - The EDITOR allows the user to modify or 

create source files for use as input to language 

processing programs such as BASIC and PALC, The EDITOR 
contains powerful text manipulation commands for quick 
and easy editing. 

3. PALC Assembler (Program Assembly Language — Cassette) 

PALC accepts source files in the PAL machine language and 
generates absolute binary files as output. These files 
can then be loaded and executed using Monitor commands. 

4. BASIC - BASIC provides a higher- level programming 

language which is easy to learn and use. It includes 
such language features as user-coded functions, data 
files on cassette, and program chaining. 

5. System Copy (SYSCOP) - SYSCOP allows the user to transfer 
files from one cassette to another, giving him the 
£±>ility to make multiple copies of a cassette and "clean 
up" full cassettes so that they may become available for 
future use. 


1.2 WHAT IS A CAPS-8 CASSETTE? 

A CAPS-8 cassette is a magnetic tape device much like that used in a 
cassette tape recorder. The tape itself and the reels it is wound on 
are enclosed inside a rectangular plastic case (see Figure 1-2) , 
making handling, storage, and care of the cassette convenient for the 
user. 
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On either end of one side of the cassette are two flexible plastic 
tabs called write protect tabs (see A in Figure 1-2) . There is one 
tab for each end of the tape; since data should only be vsxitten in one 
direction on the tape, the user will need to be concerned with only 
the tab which is specifically marked on the cassette label. Depending 
upon the position of this tab, the user is able to prctect his tape 
against accidental writing and destruction of data. When the tab is 
pulled in toward the middle of the cassette so that the hole is 
uncovered, the tape is write-locked; data cannot be written on it and 
any attempt to do so will result in an error message. When the tab is 
pushed toward the outside of the cassette so that the ho]e is covered, 
the tape is write-enabled and data can be written onto it. Data can 
be read from the cassette with the tab in either positior. . 

The bottom of the cassette (B in Figure 1-2) provides an opening where 
the magnetic tape is exposed. The cassette is locked int.o position on 
a TU60 cassette unit drive so that the tape comes in cont.act with the 
read/write head through this opening. 

Both ends of the magnetic tape in a cassette consist of clear plastic 
leader/trailer tape; this section of the tape is not used for 
information storage purposes, but as a safeguard in handling and 
storing the cassette itself. Since cassette tape is siusceptible to 
dust and fingerprints, the leader/trailer tape should be the only part 
of the tape exposed whenever the cassette is not on a drj.ve. 



Figure 1-2 


CAPS-8 Cassette 




1.2.1 The Format of a Cassette 


A cassette is formatted so that it consists of a sequence of one or 
more files. Each file is preceded and followed by a file gap. (A gap 
in this sense is a set length of specially coded tape.) All cassettes 
must start with a file gap; any information preceding the initial file 
gap is unreliable. A file consists of ci sequence of one or more 
records separated from each other by a record gap. The first record 
of a file is called the file header record and contains information 
concerning the name of the file, its type, length, and so on. 
(Chapter 2 provides more information concerning header records.) A 
record generally contains 128 (decimcil) characters of information; 
there are approximately 600 records per cassette tape. 

Records consist of a sequence of one or more cassette bytes; a byte in 
turn consists of eight bits each representing a binary zero or one. 
Characters and nuinbers are stored in bytes using the standard ASCII 
character codes (see Appendix A) and binary notation. 

The number of records of information on a . cassette tape may be 
estimated by the user. On the outside of the cassette case is a clear 
plastic window (C in Figure 1-2) . Along the bottom, of this window is 
a series of marks; each mark represents about 50 inches of magnetic 
tape. Knowing that approximately 2 records fit on an inch of tape, 
the user is able to make a reasonable guess as to the length of tape 
and number of records available for use. By simply glancing at the 
width of the tape reel showing in the window, the user can tell 
quickly if he is very close to the end. Since he is given no advance 
warning of a full tape condition, the user must visually keep track of 
the length of tape he has available. Should the tape become full 
before his file transfer has completed, cinother cassette must be 
substituted, cuid the transfer or output operation must be restarted. 


1.2.2 The Sentinel File 

The last file on a cassette tape is called the sentinel file. This 
file consists of only a file header record and represents the logical 
end-of-tape. A zeroed or blcink cassette tape is one consisting of 
only the sentinel file. 


1.3 THE SYSTEM CASSETTE 

The software discussed in Section 1.1 is provided to the user on a 
single cassette called the System Cassette. This is the cassette on 
which the entire CAPS-8 System resides, cind it is utilized for all 
system functions. The System Cassette must always be mounted on drive 
0; drive 0 serves as the default device when the user fails to specify 
another. 
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NOTE 


Each TU60 dual cassette unit has two 
drives. The drive on the left is always 
odd-nuinbered and the drive on the right 
even-numbered; thus, drive 0 will be the 
left drive. If the user has more than 
one TU60 dual cassette unit, he should 
probably Icibel the drives in consecutive 
order so that there will be no confusion 
when he is using the system. 


The write protect tab on the System Cassette should usucilly be in the 
write-locked position so that data will not accidently be written on 
it; it is suggested that the user make a copy of this cassette as 
protection against loss or accidental destruction. 


1.4 MOUNTING AND DISMOUNTING A CASSETTE 

To mount a tape on a drive, hold the tape so that the open part of the 
cassette is to the left and the full reel is at the top. Set the top 
write protect tab to the desired position depending upon whether data 
is to be written on the tape. 

Open the locking bar on the cassette drive by pushing it to the right 
away from the drive (see A in Figure 1-3) . Next hold the tape up to 
the cassette drive at approximately a 45-degree angle and insert the 
tape into the drive by applying a leftward pressure while 
simultaneously rotating the cassette over the drive sprockets. This 
brings the tape into position against the read/write head. Push the 
tape into the unit so that when the cassette is properly mounted, the 
locking bar automatically closes over the cassette back edge. (Figure 
1-3 illustrates this procedure.) 

Press the rewind button on the cassette unit (see B in Figure 1-3; 
there is a rewind button for each drive) . This causes the cassette to 
rewind to the beginning of its leader/trailer tape. (Pressing the 
rewind button ci second time causes the cassette to revrind to the end 
of the leader/trailer tape and to the physical end-of-tape. The 
cassette unit will click; this sound is almost inaudibl.e and the user 
may not hear it unless he is listening carefully. Normal usage 
requires that the user press the rewind button only once whenever he 
wishes to manually rewind a cassette) . Even though tapes which are 
not actively being used on a drive should already be positioned at the 
beginning, the user should develop the habit of automatically 
rewinding a cassette. When the tape has finished winding, the 
cassette will stop moving. The cassette is now in places and ready for 
transfer operations. 
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Figure 1-3 Mounting a Cassette 


Before removing a cassette from a drive, the tape should always be 
rewound to its beginning. This can be done by pressing the rewind 
button on the cassette unit or by issuing the REwind Monitor Command 
as explained in Chapter 2. Rewinding a tape ensures that the clear 
leader/trailer tape will be the only tcipe exposed at the open part of 
the cassette. To remove a cassette from the cassette drive, open the 
locking bar and the cassette will pop out. When cassettes are not 
being actively used on a cassette drive, they can be stored in the 
small plastic boxes provided for this purpose by the manufacturer. 

NOTE 

Before using a new cass€;tte, or prior to 
using a cassette that has just been 
shipped or accidently dropped, mount the 
cassette on a drive so that the Digital 
label faces the inside of the unit and 
perform a rewind operation. Remove the 
cassette, turn it over, and perform 
another rewind operation. This packs 
the tape neatly in the cassette and 
places the full tape reel at the proper 
tension. 


1.5 CONCERNING EXAMPLES 

In the chapters that follow, care has been taken to include acutal 
machine printout whenever possible. In cases in which there may be 
some discrepancy as to whether a character was typed by the user or by 
the system, that typc'd by the system will be underlined. 
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CHAPTER 2 

GETTING ON-LINE WITH THE CAPS-8 SYSTEM 


2.1 SYSTEM PROGRAMS 

The Cassette Programming System is distributed on a single cassette, 
called the System Cassette, which contains all the programs necessary 
for loading the Monitor into memory and creating and running system 
and user programs. The directory of the System Cassette is as 
follows : 


C2B00T.BIN 

01/22/73 

VI 

MONTOR.BIN 

01/22/73 

VI 

SybCOP.BIN 

01/25/73 

V2 

EDIT .BIN 

01/02/73 

VI 

PALC .BIN 

01/02/73 

VI 

BASIC .BIN 

01/02/73 

VI 

System files are 

in binary 

for 


: (see Section 2.2.1). The first two 
files on any System Cassette must be C2BOOT.BIN and MONTOR.BIN; these 
two files comprise a bootstrap and the Keyboard Monitor. C2B00T.BIN 
loads the Monitor into memory from the System Cassette; the Keyboard 
Monitor links the user and the CAPS-8 System by providing a means of 
communication between the two. By accepting commands from the console 
terminal keyboard, the Cassette Keyboard Monitor allows the user to 
run system and user programs, save and recall files utilizing cassette 
storage, and create, assemble, and load programs. 


2.2 SYSTEM CONVENTIONS 

The following conventions concern file formats and file naming 
procedures and ai:e standard for the CAPS-8 System, as well as for many 
other systems. 


2.2.1 File Formats 

The Cassette Programming System makes use of two types of file formats 
— ASCII and Binary. 

Files in ASCII format conform to the American National Standard Code 
for Information Interchange in which alphanumeric characters are 
represented by a 3-digit code. A table containing ASCII character 
codes in 7- and 8-bit octal is provided in Appendix A. 

Binary format files consist of 12-bit binary words representing PDP-8 
machine language code. The standard DEC binary format is used with 
the exception that no checksum is necessary. Binary files contain 
field addresses and memory instructions and are rea(3 directly into 
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memory for immediate execution. CAPS- 8 System Programs are in binary 
format, and programs which the user assembles with PALC are translated 
into files in binary format. 


2.2.2 Filenames and Extensions 

System amd user files are referenced symbolically by a name of as many 
as six alphabetic characters (A-Z) or digits (0-9) , followed 
optionally by an extension of from 1 to 3 alphabetic characters or 
digits; (the first character in a filename must be alphabetic). The 
extension to a filename is generally used as an aid in remembering the 
CAPS-8 format of a file. Table 2-1 lists commonly accepted extensions 
— the user may or may not conform to this list as he chooses; it is 
included here only as a guide: 


Table 2-1 CAPS-8 Extension Names 


Extension 

Meaning 

PAL 

PALC source file (ASCII) 

BIN 

System or user binary format file 

BAS 

BASIC source file (ASCII) 

TXT 

Text file (ASCII) 

DOC 

Documentation file (ASCII) 

DAT 

Data file (ASCII or other) 


Generally the user may call his files by any mnemonic filename and 
extension he chooses. In some cases, if he omits specifying an 
extension, the System Program he is running may assume an extension. 
For example, PALC assumes an extension of .PAL unless the user 
indicates another, and the Run command assumes .BIN unless another 
extension is specified. 


2.2.3 Input/Output Devices 

There are three available categories of input/output devices in the 
Cassette Programming System: console terminal keyboard (including 
paper tape reader and punch if an LT33 Teletype containing these units 
is used as the console terminal) , cassette drives 0-7, and a line 
printer. There are no permanent device names in the CAPS-8 System. 
Command strings and I/O designations are entered in such a way that 
the user specifies the device by a drive number cind the file by a 
filename; option characters allow the user to direct listings to the 
line printer or to otherwise change the normal operating procedure of 
a program. The System Cassette — drive 0 -- is the default device if 
no drive number is specified. For example: 


.DI/L 


2-2 





(DI is a Monitor command instructing the computer to print a directory 
listing of a cassette. Since no drive number is specified, drive 0 — 
the System Cassette — is assumed. The option character L sends 
output to the line printer instead of the console terminal, which is 
the normal output device.) 


2.3 LOADING THE KEYBOARD MONITOR 

The CAPS-8 hardware bootstrap and C2B00T.BIN on the System Cassette 
are used to load the Cassette Keyboard Monitor into memory. (Both 
bootstraps are described in Appendix E.) Loading the Monitor is 
accomplished as follows: 

1. Ensure that the computer and terminal are on-line. 

2. Press and raise the HALT key. Make sure that the SINGLE 
STEP key is in a raised position. 

3. Place the System Cassette (write- locked to protect data) 
onto cassette unit drive 0; 

4. Press and raise the SV7 key. 

At this point the RUN lamp should be on and the System Cassette should 
begin to move. The hardware bootstrap calls the first program on the 
System Cassette (C2BOOT.BIN) which in turn loads the Keyboard Monitor 
(MONTOR.BIN) into memory. If an error occurs during the loading 
process (for example, an error may be caused by the cassette being 
improperly mounted, by a missing file on the tape, or by the 
occurrence of an I/O error) no error message will inform the user 
since the Monitor is not completely in memory. Instead, the System 
Cassette may stop moving and the computer may loop or halt. If this 
is the case, steps 2-4 above should be repeated. 

Once the Monitor has been loaded, the System Cassette stops moving and 
a dot is typed at the left margin of the console terminal page. This 
instructs the user that the Monitor is now in memory and ready to 
accept input commands. 


2.4 USING THE KEYBOARD MONITOR 

Each command to the Keyboard Monitor is typed at the console terminal 
keyboard in response to the dot at the left margin. A command is 
entered by pressing the RETURN key. 


2.4.1 Making Corrections 

Corrections may be made to the command line providing they are made 
before the line is entered (that is, before a carriage return has been 
typed). The RUBOUT key is used to correct typing errors. Pressing the 
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RUBOUT key once causes an open bracket ( [) to be typed followed by the 
last character entered into memory. After this character is echoed on 
the console terminal it is deleted from memory. Successive RUBOUTs 
each cause one more character to be printed and deleted. The first 
non-RUBOUT character typed (after the last RUBOUT in a sequence) 
causes a closing bracket (] ) to be printed, thus enclosing only the 
deleted portion of text within brackets. For example: 

The user types: ,.R BACIC (RUBOUT) (RUBOUT) (RUBOUT) SIC 

The console terminal shows: QAC IC CC I C 3 S IC 

The string is entered to the Keyboard McJnitor as: .R BASIC 


2.4.2 Special Characters (CTRL/C, CTRL/0, and CTRL/U) 

Control can be returned to the Keyboard Monitor while under any of the 
System Programs by typing a CTRL/C (produced by holding down the CTRL 
key and simultaneously pressing the C key) . If the Monitor is not 
still in memory, a CTRL/C causes a complete rebootstrap by reading the 
appropriate files from the System Cassette on drive 0. When it is 
ready to accept input, the Keyboard Monitor types a dot at the left 
margin of the teleprinter (i.e. console terminal) page. 

Teleprinter output can be suppressed by typing a CTRL/0 (produced by 
holding down the CTRL key and simultaneously pressing the O key) . 
This allows execution of the program to continue, but stops all 
console printout. Typing a second CTRL/0 will resume output again. 
Unless output is extremely lengthy, or unless the program is waiting 
for input from the user, processing of a program after an initial 
CTRL/0 will usually be completed before the user is able to type a 
second CTRL/0. Printout will autom^ltically resume when control is 
returned to the Keyboard Monitor (indiccited by a dot at the left 
margin) . 


NOTE 

CTRL/0 does not prevent certain 
important error messages from printing 
on the console terminal. 


A command line may be deleted completely, before it is entered, by 
typing a CTRL/U (produced by holding down the CTRL key and pressing 
the U key) . This causes the current command line to be ignored and 
returns control to the Keyboard Monitor. The Monitor prints a dot at 
the left margin to indicate that it is ready to accept another 
command. 
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2,4.3 I/O Designations and Specification Options 

Whenever the user runs a System Program or performs any I/O operation, 
he must indicate the file(s) to be accessed, the cassette drive (s) on 
which they are located, and any desired options associated with the 
operation. Procedures used in entering this information are explained 
below. 

Monitor commands generally require only a single command line which 
specifies the unit drive number (in the range 0-7), filename(s), and 
option (s) in the following format: 

.COMMAND DRIVE #: FILENAME: . EXT/OPTION (S) 

COMMAND represents one of the eight Monitor commands discussed in 
Section 2.5. The filename should be separated from the drive number 
by a colon. Options are alphabetic charcicters and are separated from 
the rest of the command line by the slcish character (/) . Successive 
options follow one another without any separating character. The 
command line is executed by typing a carriage return. 

I/O specifications to System Programs follow a different format. 
First the System Program is called from the System Cassette using the 
Monitor Run command. The System Program then asks for the input 
filename, drive number, and options, cmd then the output filename, 
drive number, and options. This information is usually requested in 
two separate command lines, but the actual format varies between 
System Programs, Generally, the command strings appear as follows; 

.R SYSTEM PROGRAM/OPTIONS 
♦INPUT-DRIVE #: FILENAME 
♦OUTPUT-DRIVE #: FILENAME 

The appropriate chapter should be referenced for the accurate format. 

Options are available in most System Programs and Monitor commands 
allowing the user to change the order or format of input and output 
operations from that which would normally be carried out by the 
program. Again, interpretation of options varies; the user should 
refer to the appropriate section or chapter to learn which options are 
available and what actions will result from their use. 


2.5 KEYBOARD MONITOR COMMANDS 

There are eight Keyboard Monitor commands available to the user. 
Commands are typed in response to the dot printed by the Monitor and 
are entered when the RETURN key is pressed. Each command consists of 
one or more alphabetic characters, followed by a space (or any 
non-alphcibetic character) . Any error made while utilizing these 
commands will result in a message informing the user (see Section 
2.8). After occurrence of an error, control returns to the Keyboard 
Monitor and the command must be retyped. (Since several of the 
commands begin with the same letter, the user must be sure to note how 
much of the command must be entered in order to distinguish it from 
other commands. While it does not matter if too many characters are 
entered, too few will cause errors.) 
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2.5.1 Run Command 


The Run command is of the form: 

.R Drive #: Filename/Option (s) 

The Run command instructs the Monitor to load and execute the file 
specified in the command line. The file should be in self-starting 
binary format (that is, the last location in the source file must be 
an origin setting which indicates the starting address of the file) ; 
as the file is not in self-starting binary format, the program will be 
loaded but execution will not begin; the user will have to proceed as 
though he were using the Load command (see Section 2.5.2). The user 
may omit specifying an extension as the Monitor assumes .BIN. For 
example ; 


.R CART.BIN 


or 


.R CART 

Regardless of which command string the user types, the Monitor assumes 
.BIN, searches drive 0 for the file CART.BIN, and executes it. 

Options allowed in the command line depend upon the program the user 
is running. Availability of options and results of their use are 
discussed in Chapters 3, 4, 5 and 6. No error occurs if the user 
specifies an option not allowed by a program; the option is simply 
ignored. 

Multiple files may be executed using the Run command. Patches to 
programs, BASIC user-coded functions, and programs the user may have 
created using PALC can be executed as follows: 

.R Drive # :PR0G1 , Drive # :PR0G2 , . . .PROGn/Option (s) 

where n represents ciny number of programs as long as the total number 
of characters on the input specification line does not exceed 64. The 
user must enter programs in the command line in the order in which he 
wants them executed and must be careful to include appropriate 
starting, chaining, cind return addresses (see Appendix E) . 

For example, assume the user has written a routine which will be used 
for debugging purposes; each time a certain condition is met during 
execution, this routine will be accessed, print a message and cause 
execution to halt. The routine has been created using the CAPS-8 
EDITOR, assembled with PALC, and is stored on cassette drive 1 as 
DBG. BIN; it is loaded into memory with the user's program (TABLE.BIN 
stored on cassette drive 0), The programs are loaded as follows: 


R TABLE.BIN^ I : DBG .BIN 



Chapter 6 , BASIC, contains an example of running multiple files in 
conjunction with the BASIC user-coded function feature. 


2.5.2 Load Command 

The Load command is used to load a binary file into memory and takes 
the form: 


,L Drive #; Filename. ex t/Option (s) 

This command is similar to the Run command except that the computer 
halts after loading the file. To start execution, the user sets the 
correct starting address in the Switch Rejgister, presses ADDR LOAD, 
CLEAR and CONT (if the file is in self-starting binary format, the 
user need only press CONT) ; appropriate addresses included in the 
program (see Appendix E) will return control to the Keyboard Monitor 
after execution. 

Multiple files may be loaded in the same manner as in the Run command 
by simply specifying them in correct cjxecution order on the command 
line : 


.L Drive #:PR0G1, Drive # :PR0G2 . . . .PROGn/Option (s) 

Again, n may represent any number of programs as long as the total 
number of characters on the command line does not exceed 64. 


2,5.3 DAte Command 

The DAte command is of the form; 

. DA mm/dd/yy 

where mm, dd, and yy represent the current month, day and year as 
entered by the user. (One or two-digit numbers in the range 0-99 are 
allowed in the DAte command. The Keyboard Monitor does not check for 
errors other than the entry of a number which is outside this range.) 
This date will then appear in directory listings (see Section 2.5,4), 
and the date of creation of all new files will be included. If the 
DAte command is not used, directory listings will contain only 
filenames, as illustrated in Section 2.1, 


2,5,4 Directory Command 

The Directory conuTiand is of the form; 

.DI Drive #/Option(s) 

and causes a directory listing of the cassette on the drive specified 
to be output on the console terminal. No colon is necessary after the 
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drive number. There 
Directory command: 

are two options available for use with the 

Table 2-2 Directory Options 

Option 

Meaning 

/L 

Causes the listing to be output 
on the line printer rather than 
the console terminal. 

/F 

Causes a "fast" listing to be 
produced (omitting creation 
dates and version numbers) , 


In the following example a directory of cassette drive 2 is requested 
and output (the version number in the directory listing reflects the 
number of times the file has been accessed and changed using the 
CAPS-8 EDITOR; see Chapter 3, Section 3.2,3): 


FILE .BIN (>13/17/78 
ABCDEF.PAL 
A -ASC 

B 


V3 

^22 


This same directory using the F option will be reduced to: 


l(;i/29/72 
file .BIM 
abcdef.pal 

A .ASC 

B 


2.5.5 DElete Command 

The DElete command is of the form: 

.DE Drive #: Filename . ext 

and causes the filename on the specified drive number to be deleted 
from the directory. The filename is replaced by the name *EMPTY in 
the directory listing and the file can no longer be referenced. Only 
one file may be specified in the DElete command string at a time. 
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For example, assume the user wishes to delete the filename MATH, DAT 
from the directory of cassette drive 3. He types; 

.DE 3:MATH.DAT 

and then obtains a directory listing of drive 3. The directory will 
appear as follows: 

11/17/72 

tape .BAS 11/02/72 
♦EMPTY. 

TOR .ASC 11/07/72 03 


where *EMPTY represents the deleted filename MATH, DAT. 


2.5,6 Zero Command 

The Zero command is of the form; 

.Z Drive #: Filename 

and specifies that the sentinel file of the indicated cassette is to 
be moved so that it immediately follows the file indicated in the 
command line. (See Chapter 1 for a description of the sentinel file.) 
All files following the sentinel file are deleted fr(3m the cassette 
and that portion of the tape is completely reusable. 

For example, assume cassette drive 3 contains the following directory: 


LOOK .ASC 
base .BAS 
POOR *01^ 
♦EMPTY. 

RAC E . E 


10/23/72 02 

1 1/17/72 


and the user wishes to save only the first three files. He uses the 
Zero command as follows ; 


3:F0gR.BIM 

and the sentinel file is placed immediately after the file FOUR, BIN. 
The directory now reads; 


LOOK. ASC 10/23/72 02 

BASE. BAS 

FO'JR.BIN 11/17/72 
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When no filename is specifed in the command line, for example; 


.Z 1 


the cassette is said to be zeroed, or completely deleted of files; the 
sentinel file is moved to the beginning of the cassette so that the 
entire tape is availcible for use. This method is useful in "cleaning 
up" cassettes which may contain several *Er4PTY files in the directory 
listing but have become full and therefore unavailable for further 
use. First, any needed files are transfered to another cassette using 
SYSCOP (see Chapter 4) , then the directory of the old cassette is 
zeroed. The sentinel file is written at the beginning of the tape 
making the cassette completely reusable. 

All new tapes must be zeroed before they are first used. This ensures 
that a sentinel file is present on the tape and moved to the beginning 
of the tape. 


2,5.7 REwind Command 

The REwind command is of the form; 

. RE Drive # 

and causes the cassette on the drive nuitiber specified to be rewound to 
its beginning, (The user can also cause the tape to rewind by 
pressing the rewind button on the cassette unit.) System Programs and 
Monitor commands always rewind a cassette before accessing a file, but 
if the user delevopes the habit of rewinding the cassette himself he 
performs a timesaving action. A cassette should always be rewound 
before it is removed from a drive. 


2.5.8 Version Command 

The Version command is used to find out the version number of the 
Monitor currently in use. Typing; 


.V 

instructs the Monitor to respond with the appropriate number. For 
excimple ; 


VI 


indicates that version 1.2 is currently in use. 
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2.6 NOTES ON DEVICE HANDLERS 


Device handlers for the CAPS-8 System are described in Appendix E. A 
few notes of interest concerning their use are included here. 

The line printer performs a form feed operation before beginning an 
output task. Characters are unpacked from the outj^ut buffer and 
printed. A form feed is also produced following the comjjletion of an 
output task. The line printer handler is capeible of handling only an 
80 column printer.. 

If the console terminal is an LT33 Teletype containing reader and 
punch units, these may be used as input/output devices in conjunction 
with the Teletype keyboard. To punch a tape, simply place the punch 
unit to ON; to read a tape, place the reader unit to START, 
Characters will be printed on the Teletype keyboard as they are read 
or punched. Binary tapes may not be punched. 

NOTE 

The purpose of the Cassette Programming System is 
the elimination of paper tape procedures. 

Cassettes provide a more convenient, reliable and 
faster means of program storage than paper tape. 

Therefore, although paper tapes may be read and 
punched using the LT33 paper tape units, there is 
no support for this type of I/O and its use is not 
encouraged. 


If the user's program does not over-write certain areas of memory, the 
parts of the Monitor which are in these locations are available for 
use. This allows the user who takes advantage of writing his own 
programs in the PAL machine language to access system handlers and to 
restart or rebootstrap the Cassette Keyboard Monitor after program 
execution. Information concerning Monitor Service Routines, I/O 
routines, device handlers, and internal descriptions of the Keyboard 
Monitor are provided in Appendix E. 
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2.7 KEYBOARD MONITOR ERROR MESSAGES 


The following error messages may occur when the Keyboard Monitor is 
used incorrectly : 

Table 2-3 Keyboard Monitor Error Messages 
Message Meaning 

BAD COMMAND The user has failed to follow the 

correct syntax for Monitor commands. 

This may be the result of mispelled 
commands or too many or improper 
arguments in a command string. 

FILE NOT FOUND The Monitor could not locate the file 

(or files) specified. The user should 
check to be sure that filenames are 
spelled correctly and that the unit 
drive number specified is correct. 

INPUT ERROR ON UNIT n An I/O error has occurred on the cas- 

OUTPUT ERROR ON UNIT n sette drive specified. This may be 

caused by an incorrectly formatted 

cassette or may be due to a timing 

error. The user should try the I/O 
transfer using another cassette. 

UNIT n NOT READY There is no cassette on the drive 

specified, or no such drive exists. 

Ul'ILOCK UNIT n The user tried to write data when the 

write protect tab of the cassette on 
the drive specified was write-locked. 

To write data this tab must be 
write-enabled. 
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CHAPTER 3 
SYMBOLIC EDITOR 


3.1 INTRODUCTION 

The CAPS- 8 Symbolic EDITOR is used to create and modify ASCII source 
files so that these files may be used as input t(5 other System 
Programs such as BASIC and PALC. 

The EDITOR considers a file to be divided into logical units called 
pages. A page of text is generally 50-60 lines long, aiid corresponds 
approximately to a physical page of a program listing. (Note that 
this is not the same as a memory page) . The EDITOR reads one page of 
text at a time from the input file into its internal buffer where the 
page becomes availcible for editing. The* Editor contains commands for 
creating, modifying, or deleting characters, lines, or complete 
logical pages of text. All commands consist of a single letter or a 
letter with arguments, and are executed by typing the RETURN key. 


3.2 CALLING AND USING THE EDITOR 

To call the EDITOR from the System Cassette, type: 

. R EDIT/Options 

in response to the dot (.) printed by the Keyboard Monitor. 


3.2.1 EDITOR Options 

There are two options availcible for use with the EDITOR; these are 
described in Table 3-1. (Option usage has been previously discussed 
in Chapter 2, Section 2.4.3). 


Table 3-1 EDITOR Options 


Option Meaning 

/B Convert two or more spaces to a TAB when 

reading from input device. 

/M More than one file will be used for input. 

(When one of these commands — E, F, J, N, R, 
or Y — is issued and an end-of-file is 
encountered, the EDITOR pauses and requests 
that the user specify another input file, 
thus allowing continuation of the command. 
If the /M option has not been previously 
specified in the input line, the end-of-file 
condition remains in effect. See Section 3.9 
for an example.) 
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3,2.2 Input and Output Specifications 

After the EDITOR has been called from the System Cassette it asks for 
the input specification as follows: 


FILE- 

The user responds with the input cassette drive number and the input 
filename and extension, if any. For example: 

FILE~ 1 : ABA. PAL 

If only a filename (and no input cassette drive) is specified, the 
default device — drive 0 — is assumed; the EDITOR prints the user's 
input specification line, only first it includes the assumed default 
device before echoing the filename, as illustrated below: 


+ FILE~0 : AR 


The user has typed the filename AB, but before this is printed, the 
EDITOR inserts 0: and then goes on to echo AB. If the input file is 
not found or if a syntax error occurs, the EDITOR prints a question 
mark (?) , types an asterisk (*) at the left margin, and waits for 
cinother input designation. Any number of input files is permitted. 

If no input specification is made, (that is, a carriage return only 
has been typed in response to the INPUT request) , a new file will be 
created using the console terminal keyboard as the input device. The 
EDITOR allows input from the keyboard via the Append command (see 
Example Using the EDITOR for an illustration of this method of 
creating a program) . 

If more than one input file is to be entered, the /M option must be 
specified when the EDITOR is called from the System Cassette, The 
user responds to the INPUT FILE line with the drive number and 
filename of the first input file. He enters output information as 
described next, and then edits his file. When the end-of-file is 
reached during the editing procedure, the EDITOR again prints the 
INPUT FILE request cind the user responds with the drive number and 
filename of the second file. When the user finishes editing his final 
file and no more input files are available, he responds to the 
editor's input request by typing a carriage return; the EDITOR 
continues cind closes the output file. All input files are combined 
under the one filename specified in the output line. 

The EDITOR initially requests output info;rmation by printing; 


♦OUTPUT FILE 
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The user responds with the output drive number and filename. For 
example ; 


JT FILHl-^tO'jr.EXT 


Again, if no device is designated, drive 0 is assumed and echoed. 

If the output file is to have the same name as the input file, the 
user need only type the correct output drive number followed by a 
carriage return; the EDITOR will echo the assumed name. For example: 

♦ IMP^TT FILE- 1 : FILE. PAS 
»0 IT FILE- Pi FILE.BAS 


The EDITOR allows only one output file and creates the header for this 
file on the specified cassette, deleting any file already on that 
cassette under the same name (and replacing it with ’'^EMPTY in the 
directory listing) and leaving the cassette correctly postioned for 
further output. 


NOTE 

If no output designation is specified 
(that is, a carriage return only has 
besen typed in response to the OUTPUT 
FILE request) , the only output 
operations which may be performed are L 
(list buffer on the console terminal) or 
V (list buffer on the line printer) . 


Only cassette files in ASCII mode are acceptable foi: use by the 
EDITOR. No error message is given if non-ASCII files are input, but 
the results of editing operations are garbled. 

Once I/O file designations are entered, the Symbolic EDITOR is ready 
to accept commands from the keyboard. It signifies thiss by printing a 
number sign (#) at the left margin; this symbol occurs whenever the 
EDITOR is waiting for a command. 


3.2.3 Version Numbers 

Each time a filename is indicated in response to th€j output file 
specification line, the number 0 is assigned to it. This number 
(called the version number) signifies that a new file has been created 
cmd that it has not been previously edited or referenced under this 
filename. 

The user may call a file from a specified cassette, make corrections 
to it and change it any number of times before he is finally satisfied 
with it or ready to use it for some other operation. In this case, he 
may reference the file in the output specification line* by specifying 
only the output cassette drive number followed by a cairriage return, 
since the filename itself will not be changed. Each time he does 
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this, the version number of the file is increased by 1. When the 
version number of a file has been incremented in this manner so that 
it is greater than 0, it appears in directory listings on the same 
line as the filename (see Chapter 2). 

NOTE 

Version numbers associated with edited 
files should not be confused with the V 
Monitor command, which prints the 
version of the Monitor currently in use. 


3.3 MODES OF OPERATION 

The EDITOR operates in one of two different modes: command mode or 
text mode. In command mode all input typed on the keyboard is 
interpreted as commands instructing the EDITOR to perform some 
operation. In text mode, all typed input is interpreted as text to 
replace, be inserted into, or be appended to the contents of the text 
buffer. 


3,3.1 Transition Between Modes 

Immediately after being loaded into memory and started, the EDITOR is 
in command mode. The special character # is printed at the left 
margin of the teleprinter page indicating that the EDITOR is waiting 
for a command. All commands are terminated by pressing the RETURN 
key. 

In text mode, the EDITOR performs I/O operations on text stored within 
the text buffer. Text is input to the EDITOR buffer until a form feed 
is encountered. A line of text is terminated by a carriage return. 
If no carriage return is present, the text entered on the current line 
is ignored. The buffer has room for approximately 5200 (decimal) 
characters. When text has been input to the extent that there are 
only 256 decimal locations available in the buffer, the console 
terminal rings a warning bell. From this point on, whenever a 
carriage return is detected during text input, control returns to the 
EDITOR command mode and the bell is rung. This line-at-a-time input 
may continue until the absolute end-of-buf fer is encountered. At this 
point, no more text will be accomodated in the buffer; a is 
printed and control returns to command mode every time the user 
attempts to input more text. 


3.4 SPECIAL CHARACTERS AND FU^^ICTIONS 

A number of the console terminal keys have special operating 
functions. These keys and their associated functions are described 
be low , 
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3.4.1 RETURN Key 


In both coinmand and text modes, typing the RETURN key causes a 
carriage return and line feed operation and signals; the EDITOR to 
process the infomation just typed. In command mode, iit allows the 
EDITOR to execute the command just typed. A command will not be 
executed until it is terminated by the PETURN key (with the exception 
of =, explained later). In text mode, RETURN causes tlie line of text 
which it follows to be entered in the text buffer. A typed line is 
not actually part of the buffer until terminated by the RETURN key. 


3.4.2 Erase (CTIUij/U) 

The erase character (CTRL/U combination) is used for error recoveries 
in both command and text modes. It is generated by holding the CTRL 
key while simultcineously typing the U key. When used :Ln text mode, 
CTRL/U cancels everything to its left back to the beginning of the 
line; the EDITOR echoes i U and performs a carriage return/line feed 
(CR/LF) ; the user then continues typing on the next Irne. When used 
in command mode, CTRL/U cancels the entire command; the EDITOR 
performs a CR/LF and prints a #. The erase characte]: cannot cancel 
past a CR/LF in either command or text mode. 


3.4.3 RUBOUT Key 

Rubout is used in error recovery in both command and text modes. In 
text mode typing the RUBOUT key echoes a backslash (\) and deletes the 
last typed character. Repeated rubouts delete from right to left up 
to, but not including, the CR/LF which separates the current line from 
the previous one. For example: 

the Q'JiJICKWW ICK RROWM FOX 

will be entered in the buffer as: 


the hoick bhowo fox 

when used in command mode, RUBOUT is equivalent to the (3TRL/U feature 
and cancels the entire command; the EDITOR prints a #, performs a 
CR/LF, and waits for another command to be entered. 


3.4.4 Form Feed (CTRL/FORM) 

A form feed signals the EDITOR to return to command mode. A form feed 
character is generated by typing the CTRL .and FORM keys 
simultaneously. This combination is typed while in text mode to 
indicate that the desired text has been entered and that the EDITOR 
should now return to command mode. The EDITOR performs a CR/LF and 
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prints a # in response to a CTRL/FORM to indicate that it is back in 
command mode. CTRL/G is usually equivalent to CTRL/FORM except in the 
case of a SEARCH command, as explained in Section 3.8.1. 


3.4.5 The Current Line Counter (.) 

The EDITOR keeps track of the implicit decimal number of the line on 
which it is currently operating. The dot (produced by typing the 
period key) stands for this number and may be used as an argument to a 
command. For example, .L means list the current line; .-1,.+1L means 
list the line preceding the current line, the current line, and the 
line following it, then update the dot (current line counter) to the 
decimal number of the last line printed. 

The following commands affect the current line counter as indicated; 

1. After a Read or Append command, the current line counter 
is equal to the number of the last line in the buffer. 

2. After an Insert or Change command, the current line 
counter is equal to the number of the last line entered. 

3. After a List or Search command, the current line counter 
is equal to the number of the last line listed. 

4. After a Delete command, the current line counter is 
equal to the number of the line immediately after the 
deletion. 

5. After a Kill command, the current line counter is equal 
to 0 . 

6. After a Get command, the current line counter is equal 
to the number of the line printed by the GET. 

7. After a Move command, the current line counter is not 
updated and remains whatever it was before the command 
was issued. 


3.4.6 Slash (/) 

The slash symbol (/) has a value equal to the decimal number of the 
highest numbered line in the buffer. It may also be used as cin 
argument to a command. For example; 10, /L means list from line 10 to 
the end of the buffer. 


3.4.7 LINE FEED Key 

Typing the LINE FEED while in command mode is equivalent to typing .+1 
and will cause the EDITOR to print the line following the current one 
and to increment the value of the current line counter by one. 
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3.4.8 ALT MODE Key 


Typing the ALT MODE key while in command mode will cause the line 
following the current line to be printed and the current line counter 
to be incremented by one. If the current line is also the last line 
in the buffer, typing either ALT MODE or LINE FEED will gain a 
response of ? from the EDITOR indicating that there is no next line. 
Some console terminals provide an escape key (ESC) in place of the ALT 
MODE. Their functions are identical. 


3.4.9 Right Angle Bracket (>) 

Typing the right angle bracket (>) while in command mode is equivalent 
to typing ,+lL and will cause the EDITOR to echo > and then print the 
line following the current line. The value of the current line 
counter is increased by one so that it refers to the last line 
printed. 


3.4.10 Left Angle Bracket (<) 

Typing the left angle bracket ( <) while in command mode is equivalent 
to typing .-IL and will cause the EDITOR to echo < and then print the 
line preceding the current line. The value of the current line 
counter is decreased by one so that it refers to the last line 
printed. 


3.4.11 Equal Sign (=) 

The equal sign is used in conjunction with the pointer's dot (.) or 
slash (/) . IVhen typed in command mode the equal sign causes the 
EDITOR to print the decimal value of the argument preceding it. In 
this way the user may determine the number of the current line (,= ) , 
or the total number of lines in the buffer (/= ) , or the number of 
some particular line (/-8= ) without counting lines from the beginning 
of the buffer. No carriage return need be typed following the equal 
sign. 


3.4.12 Colon (:) 

Typing a colon produces the Scime result as the equal sign (=) , 


3.4.13 Tabulation (CTRL/TAB) 

The EDITOR is written in such a way as to simulate tab stops at 
8-space intervals across the teleprinter page. When the CTRL key is 
held down eind the TAB key is typed, the EDITOR produces a tabulation, 
A tabulation consists of from one to eight spaces, depending on the 
number needed to bring the carriage to the next tab stop. Thus, the 


3-7 



EDITOR may be used to produce neat columns on the teleprinter or line 
printer page. The tab function is used in conjuction with the /B 
option (for input and output) to allow the user to produce and control 
tabulations in the text buffer during input operations. On input 
(under a Read command) , the EDITOR will replace a group of two or more 
spaces with a tabulation if the user has specified the /B option. 


3.5 COMMAND STRUCTURE 

A command directs the EDITOR to perform a desired operation. Each 
command consists of a single letter, preceded by zero, one, two or 
three arguments. The command letter tells the EDITOR what operation 
to perform; the arguments usually specify which numbered line or lines 
of text are affected. Command format is illustrated in Table 3-2, 
where E represents any command letter. 


Table 3-2 Command Format 


Type of Command 

Command 

Format 

Meaning 

No Argument; 

E 

Perform operation E 

One argument : 

nE 

Perform operation E on the 

referenced line. 

Two Arguments : 

m,nE 

Perform operation E on lines m 
through n, inclusive. 

Three Arguments; 

m,n$ jE 

This combination is used by the 

MOVE command only and is explained 
in Section 3.6.3, 


3.6 COMMAND REPERTOIRE 

Commands to the EDITOR are grouped under three general headings: 

Input Commands 
Output Commands 
Editing Commands 

Explanation of the three types of commands is detailed in the 
following sections. Each command description will state if the EDITOR 
returns to command mode after completing the operation specified by 
the command. All commands are entered when the RETURI'I key is typed. 

The EDITOR prints an error message consisting of a question mark 
whenever the user has requested nonexistent information or used 
inconsistent or incorrect format in typing a command. For example, if 
a command requires two arguments, and only one (or none) is provided, 
the EDITOR will print ?, perform a carriage return/line feed, and 
ignore the command as typed. Similarly, if a nonexistent command 
character is typed, the error message ? will be printed, follov/ed by a 
carriage return/line feed; the command will be ignored. However, if 
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cin argument is provided for a commmand that does not require one, the 
argument will be ignored and the normal function of the commmand 
performed. For example: 


User Types : 


Result: 


L 

? 


The buffer is empty. The user is asking for 
nonexistent information. 


7,5L The arguments are in the wrong order. The 

? EDITOR cannot list backwards. 


17$10M This command requires two arguments before 
? the $; only one was provided. 

H The user types a nonexistent command letter. 

? 


3.6.1 Input Commands 

Two commands are available for inputting text, and are described in 
Tcible 3-3. 


Table 3-3 Input Commands 


Command Format 


Action and Explanation 


A #A Append the incoming text from the console 

terminal keyboard to the information 
already in the buffer (if there is no 
input file the buffer will be empty 
initially) . The EDITOR will enter text 
mode upon receiving this command and the 
user may then type in ciny number of lines 
of text. The new text will be appended to 
the information already in the buffer, if 
any, until a form feed (CTRL/FORM key 
combination) is typed; control then 
returns to command mode. 

By using the Append command with an empty 
buffer, a symbolic program may effectively 
be generated on-line by entering the 
program via the keyboard. 

Any rubout encountered during execution of 
an Append command will delete the last 
typed character. Repeated rubouts will 
delete from right to left up to but not 
beyond the beginning of the current line. 





Table 3-3 Input Commands (Cont'd) 


Command Format Action and Explanation 


R #R Read a page of text from the input file on 

the specified unit drive. The EDITOR will 
read information from the input file until 
a form feed character (CTRL/FORM key 
combination) is detected or until the 
EDITOR senses a text buffer full 
condition. All incoming text except the 
form feed is appended to the contents of 
the text buffer. Information already in 
the buffer remains there. 

NOTE 

In both these commands, the 
EDITOR ignores ASCII codes 340 
through 376. These codes 
include the codes for the lower 
case alphabet (ASCII 341-372) . 

The EDITOR returns to command 
mode only after the detection of 
a form feed or when a buffer 
full condition is reached. 


3.6,2 Output Commands 

Output commands are subdivided into list and text transfer commands. 
List commands will cause the printout of all or any part of the 
contents of the text buffer to permit examination of the text. Text 
transfer commands provide for the output of form feeds , corrected 
text, or for the duplication of pages of an input file. List or text 
transfer commands do not affect the contents of the buffer. 


List Commands 

The commands in Table 3-4 cause part or all of the contents of the 
text buffer to be listed on the console terminal or line printer. 

Tcible 3-4 List Commands 


Command Format Action and Explanation 


L 


L 


#L LIST the entire page. This causes the 

EDITOR to list the entire contents of the 
text buffer on the console terminal. 

#nL LIST line n. This line will be printed 

followed by a carriage return and a line 
feed. 
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Tcible 3-4 List Commands (Cont'd) 


Command 

Format 

Action and Explanation 



L 

#m,nL 

LIST lines m through n inclusive 
console terminal. 

on 

the 

V 

#v 

List the entire text buffer on 
printer (if one is available) . 

the 

line 

V 

#nV 

List line n of the buffer on 
printer. 

the 

line 

V 

#m,nV 

List line m through n inclusive 
line printer. 

on 

the 


The EDITOR remains in command mode after a list command, and the value 
of the current line counter is updated so as to equal the number of 
the last line printed. 


Text Transfer Commands 

The following commands control the output of text and form feeds. The 
EDITOR is designed to minimize the possibility of illegal or 
meaningless characters being written into a source file; therefore the 
illegal (nonexistent) codes 340-376 and 140-177, and most illegal 
control characters will not be output. 

Table 3-5 Text Transfer Commands 


Command Format 


Action and Explanation 


E 


P 

P 

P 


N 


#E Output the current buffer to the output 

file and transfer all input to the output 
file; close the output file, 

#P Transfer the entire contents of the text 

buffer to the output buffer. 

#nP Transfer line n only to the output buffer. 

#m,nP Transfer lines m through n inclusive 

(where m must be less than n) to the 
output buffer. When the output buffer 
becomes full, the text is output to the 
indicated output file. The P command 
automatically outputs a FORM character 
(214) after the last line of output, 

#N Transfer the contents of the text buffer 

to the output buffer, delete the text 
buffer and read in the next logical page 
of text from the input file. 
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Table 3-5 Text Transfer Commands (Cont'd) 

Command Format Action and Explanation 

N #nN Execute the above sequence n times. If n 

is greater than the number of pages of 
input text, the command will proceed in 
the specified sequence until it reads the 
end of the input file, then it will return 
to command mode. 

The N command cannot be used with an empty 
text buffer, A ? is printed if this is 
attempted. 

Q #Q Immediate end-of-file. The Q command 

causes the entire text buffer to be 
output. All text written into the output 
buffer is then written into the output 
file and the file closed, with control 
returning to the Cassette Keyboard 
Monitor. 


3.6.3 Editing Commands 

The following commands permit deletion, alteration, or expansion of 
text in the buffer. 

Table 3-6 Editing Commands 
Command Format Action and Explanation 

B #B List the numJber of available memory 

locations in the text buffer. The EDITOR 
returns the number of locations on the 
next line. To estimate the number of 
characters that can be accomodated in this 
area, multiply the number of free 
locations by 1.7. 

C #nC Change line n. Line n is deleted, and the 

EDITOR enters text mode to accept input. 

The user may now type in as many lines of 
text as he desires in place of the deleted 
line. If more them one line is inserted, 
all subsequent lines will be automatically 
renumbered and the line count will be 
updated appropriately. A CTRL/FORM 
terminates the command. 

C #m,nC Change lines m through n inclusive (m must 

be numbered less the n) . Lines m through 
n are deleted and the EDITOR enters text 
mode allowing the user to type in any 
number of lines in their place. All 
subsequent lines will be automatically 
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Tcible 3-6 Editing Commands (Cont*d) 

Command Format Action and Explanation 

renumbered to account for the; change and 
the line count will be updated. 

After cuiy Change operation, a return to 
command mode is accomplishesd by typing a 
CTRL/FORM, After a Change, t:he value of 
the current line counter ( . ) is equal to 
the number of the last line j.nput. The C 
command utilizes the Text Collector in 
altering text (see Section 3.7). 

D #nD Delete line n. Line n is removed from the 

text buffer. The current line counter and 
the numbers of all succeeding lines are 
reduced by one, 

D #m,nD Delete lines m through n inclusive. The 

space used by the line to be deleted is 
reclaimed as part of the Delete function 
(refer to Section 3.7, Text Collection), 

F #F Used during a string search. Find the 

next occurrence of the string currently 
being searched for (see Stiction 3,8,2, 
Inter-Buffer Character String Search) , 

G #G Get and list the next line which has a 

Icibel associated with it. (A label in 
this context is any line oj: text which 

does not begin with a space, slash, TAB, 
or RETURN) , The EDITOR begins with the 
line following the current l:.ne (line .+1) 
cind tests for a line with a leibel. This 
will most often be a line beginning with a 
tag; it might also be a line containing an 
origin. For example: 

tad (This is the current 

DC A line) 

/THIS IS A COMivieiMT 

(71 (This line would be 

printed by the command 
G) 


TAD 

ISZ 

+ 5P50D (This line would also 

be printed if another 
G were typed) 

G #nG Get and list the next line which begins 

with a label; the EDITOR becjins at line n 
and tests it and each succeeding line as 
described in the preceding example. 
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Table 3-6 Editing Commands (Cont'd) 


Command Format Action and Explanation 


I 


I 

J 


K 


Both G and nG update the current line 
counter after finding the specified line. 
However, if either version of the GET 
command reaches the end of the buffer 
before finding a line beginning with an 
ASCII character other than a tab, slash, 
or space, the current line counter retains 
the value it v^as assigned before the GET 
was issued, and a ? is typed to indicate 
that no tagged line was found. The EDITOR 
remains in conunand mode after a GET 
command . 

#nl Insert the typed text before line n until 

a form feed (CTRL/FORM) is encountered. 
The EDITOR enters text mode to accept 
input. The first line typed becomes the 
new line n. Rubouts are recognized. Both 
the line count and the numbers of all 

lines following the insertion are 
increased by the number of lines inserted. 
The value of th€i current line counter is 
equal to the number of the last line 

inserted. To reenter command mode, the 
CTRL/FORM key combination must be typed 
(terminating text mode) . If this is not 
done, all subsequent commands will be 
interpreted erroneonusly as text and 
entered in the program immediately after 
the insertion. 

#I Insert text before line 1 (when used 

without an argument) . 

#J Initiate an inter-buffer string search 

(See Section 3.8.2, Inter-buffer Character 
String Search) . 

#K Kill (delete) the entire page in the 

buffer. The values of the special 
characters (/) and (.) are set to zero. 

The EDITOR remains in command mode. 

NOTE 

The EDITOR ignores the commands 
nK or m,nK. This prevents the 
buffer from accidently being 
destroyed if the user intended 
to type a List command (m,nL) . 
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Table 3-6 Editing Commands (Cont'd) 


Command 

Format 

Action and Explanation 

M 

#m,n$jM 

Move lines m through n inclusive to before 
line j (m must be numerically less than n 
and j may not be in the range between m 
and n) . Lines m through n are deleted 
from their current position and are 
inserted before line j . The lines are 
renumbered after the move is completed 
although the value of the current line 
counter (,) is uinchanged, as moving lines 
does not use any additional buffer space. 

(The $ character is produced by typing a 
SHIFT/4.) 



A line or group of lines may be moved to 
the end of the buffer by specifying j as 
/+1. For example, 1,10$/+1M. Since the 
MOVE command requires three arguments, it 
must have three arguments in order to move 
even one line. This is done by specifying 
the same line number twice. For example, 
5,5$23M. This will move line !> to before 
line 23. The EDITOR remains in command 
mode after a Move command. 

S 

#nS 

Search line n for the character specified 
after typing the S and a carriage return. 
Allow modification of the line when the 
character is found, (See Section 3.8.1, 
Single Character String Search.) 

Y 

#nY 

Skip to a logical page in the input file, 
without writing any output. For example, 
#5Y. , This command reads through 4 
logical pages of input, deleting them 
without producing output. The fifth page 
is read into the text buffer cind control 
automatically returns to command mode. If 
there are no more pages of input, the 
EDITOR issues a ? and returns to command 
mode. 

$ 

#$TEXT" 

#$TEXT' 

#” 

Perform a character string search for the 
string TEXT (see Section 3.8,. 2, Intra- 
Buffer Character String Search) . 
Following a string search, causes a 
search for the next occurrence of the 
string. 


3.7 TEXT COLLECTION 

The CAPS-8 EDITOR contains an automatic text collector which reclaims 
buffer space following the use of a D, S, or C command. If a full 
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buffer condition is reached, the user may output lines of text (using 
the P command, for excimple) , eind then delete these lines from the 
buffer — text collection is automatic and always occurs on the three 
commands mentioned above. 


NOTE 

If extremely large amounts of text are deleted, 
the text collection process could take several 
seconds. For small amounts of text, no 
appreciable time is lost. 


3,8 CHARACTER SEARCHES 

Two types of searches were mentioned in Table 3-6 — the standard 
character search and the character string search. Each is explained 
in turn. 


3,8,1 Single Character Search 

The single character search may take one of the following forms: 

#S 

or 

#nS 

or 

#m,nS 

where m and n represent line numbers (m<n) , and S initiates the search 
command. This command searches the entire text buffer (or the line(s) 
indicated) for the search character. The search character is typed by 
the user after he types the RETURN key which enters the command, and 
does not echo on the teleprinter. The EDITOR prints the contents of 
the entire buffer or the indicated line(s) until the search character 
is found. When the search character is found, printing stops and the 
user types a response chosen from the following table: 

Table 3-7 Search Charcicter Options 


Option Result 


text Enter text at that point at which 

the search character was found and 
printing stopped, 

CTRL/G (bell rings) Change thes search character to the 

next character typed; search 
continues. If the character is not 
contained in the line , the 
remainder of the line will be typed 
and control will be returned to 
command mode, (For example, CTRL/G 
CTRL/G would cause the remainder of 
the line to be listed,) 
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Tcible 3-7 Search Character Options (Cont'd) 


Option 


Result 


CTRL/FORM 
RETURN key 
LINE FEED key 


RUB OUT key 


Continue searching for the next 
occurrence of the characteir. 

End line here, dele1:ing all 
subsequent text on that l:.ne. 

Make two lines out of th€» current 
line. Typing a line feed actually 
inserts a carriage return without 
returning control to command mode. 

Delete characters from the line, A 
rubout echoes a backslash (\) for 
each character deleted. When all 
characters have been deleted, 
echoing of ”\" stops. 


3,8,2 Character String Search 

The character string search can identify a given line in the buffer by 
the contents of that line or any unique combination of characters. 
This search returns the line number as a parameter that can be used to 
further edit the text. There are two types of string search 
available: intra-buffer search and inter-buffer search. 


Intra-Buffer Character String Search 

The intra-buffer search scans all text in the current buffer for a 
specified character string. If the string is not found, a ? is 
printed and control returns to command mode. If the string is found, 
the number of the line which contains the string is put into the 
current line counter and control waits for the user to issue a 
command. Thus, searching for a character string in this manner 
furnishes a line number which can then be used in conjunction with 
other EDITOR commcinds. This provides a useful framework for editing, 
as it eliminates the need to count lines or search for line numbers by 
listing lines. 

An intra-buffer search is signalled by typing the ALT MODE key (which 
echoes as $) in response to the # printed by the EDITOR, The user 
then types the string to be found (as many as 20 characters may be 
specified — any additional characters typed are echoed but not included 
in the search) , The search string cannot be broken across line 
boundaries. Typing a single quote (') terminates the character 
string; when the RETURN key is typed the search is performed beginning 
at line 1 of the text buffer. Use of the double quote (”) causes the 
search to begin at the current line +1, (Use of ' and " as command 
elements prohibits their use in the search string,, An incorrect 
response resets the current line counter to the beginning of the 
buffer. ) 
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For example, assume the text buffer conteiins the following text: 


ABC DEF liJO 
1A2B3C4D5E6 
.STRINGABCD 


The user wants to list the line that contains ABC; this could be done 
by typing: 

#$ABC 'L 

The search begins with line 1 and continues until the string is found. 
The current line counter is set equal to the line in which the string 
ABC occurred, and the L command causes the line to be printed as 
follows : 


ABC DEF tiJO 

Control returns to command mode, awaiting further commands. If the 
user wanted to find the next reference to ABC, he could type: 


f'L 

In this case, " is a command which causes the last string searched for 
to be used again, with the search beginning at the current line +1. 
It is not necessary to enter the search string again. The command may 
be used several times in succession. For example, if the user wanted 
to find the fourth occurrence of a string containing the characters 
FEWMET he could type: 

#S FEWKET"* L 

This command lists the line which contains the fourth occurrence of 
that string. The L (List) command (or any other command code) can be 
given following either ' or ”, The L command causes the line to be 
listed when and if it is found. 

In order to clear the text string buffer, the user can type: 

_#S ' 

The system responds with a question mark and the text string buffer is 
cleared. 

The properties of the commands ' and " allow for easy and useful 
editing, as the following example illustrates. In order to change GIF 
20 to GIF 10, the user can issue the following commands; 
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#$D7M>’SCIF 20'’C 

GIF 17 /'MEw FIELD (CTRL/FORM) 

The above set of instructions first causes the EDITOR to start at line 
1 and search for a line beginning with DUM,. A search is then made 
for GIF 20, starting from the line after the line containing the 
string DUM, . When this string is found, the line number of the line 
containing the string GIF 20 becomes thci current line number. The G 
command is given, and the user then changes the line to the correct 
instruction, GIF 10 /NEW FIELD . 

Since this search feature produces a line number as a result, any 
operations which can be done by explicitly specifying a line number 
can be done by specifying a string instead. For example; 

#SSTEINb ' +4L 

will list the fourth line after the first occurrence of the text 
STRING in the text buffer. 


#SLABEL1 > • ,LABEL2^ "L 

will list all lines between the two labcils, inclusive. 

#SPFLfIG' S 

will do a character search on the line which contains PFLUG. (The 
user types the search character after typing the RETURN key that 
enters the line.) 

In cases where both strings and explicit numbers are used, strings 
should be used first. For example, the following commands; 

_#1+?BAD! 'L 

will not list the next line after the string BAD! occurs. The correct 
syntax is ; 


#SBAD' • +1L 


Inter-Buffer Gharacter String Search 

The inter-buffer search scans the current text buffer for a character 
string. If the string is not found, the current buffer is written to 
the output file, the buffer is cleared, and the next buffer is read 
from the input device. The search then resumes at line 1 of the new 
buffer. This process continues until either the string is found or no 
more input is left. If input is exhausted, control returns to command 
mode with all the text having been written to the output file. If the 
string is found, control returns to command mode with the current line 
equal to the numlDer of the line containing the first occurrence of the 
string. For example, a command to find the character string GONZO may 
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appear as follows: 


#J 

SUOfvJZO* 

#.=0024 

“ T 

The J command initiates an inter-buffer search; the $ is printed 
automatically by the EDITOR, and the user types in the character 
string he wishes to search for. The search proceeds, cuid when the 
string is found, control returns to command mode. The user types the 
.= construction to discover the number of the line in the current 
buffer on which the string is contained. To find further occurrences 
of the string GONZO, the user can use the F command. The F command 
uses the last character string entered to search the buffer starting 
from the current line count +1. 


#F 

#.=0106 


The above example causes a search for the string GONZO starting at the 
current line +1. If no output file is specified in the J or F 
commcinds , the EDITOR reads the next input buffer without attempting to 
produce any output. This provides an easy way of paging through text 
for a particular string. 

After the J or F commands have processed the entire input file, eui E 
or Q command must be executed to close the output file. 

The following two commands may be used to abort the string search 
command, once given; 

Tcible 3-8 Terminating a String Search 


Command 


Explanation 


CTRL/U A CTRL/U will return control to the 

EDITOR command mode if executed while 
entering text in a string search 
command; the string search command is 
ignored, as in the following example; 

#J 

SWORDtfJ 

# 

The inter-buffer search for the 
characters WO:rD was adjorted by the user 
typing +U before terminating the string 
with ' or ". 

RUBOUT Executing the RUBOUT key while entering 

text for use in a string search causes 
the text so far entered to be ignored 
and allows a new string to be inserted. 
The EDITOR answers the command by typing 
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Table 3-8 Terminating a String Search (Cont'd) 


Command Explanation 


$, as seen in the following example: 

fSCHAF? (RUBOUT) 

$ 


An example of the use of the character string search is contained in 
the EDITOR Demonstration Run found at the end of this chapter. 


3.9 EDITOR ERROR MESSAGES 

Errors made by the user while running the EDITOR may be of two types. 
Minor errors (such as an EDITOR command string error, an attempt to 
execute a read or write command without assigning a device, or a 
search for a nonexistent string) will cause a question mark to be 
typed at the left margin of the teleprinter paper. The command may be 
retyped. 

Major errors force control to return to the Keyboard Monitor and may 
be due to one of the causes listed in Table 3-9 . These errors cause a 
message to be typed in the form: 


?n iC 

where n is one of the error codes in Table 3-9 and indicates that 

control will pass to the Keyboard Monitor when a character is typed. 


Table 3-9 EDITOR Error Codes 


Error Code 


Meaning 


0 The EDITOR failed in reading from a 

device. An error occurred in the device 
handler; most likely a hardware 
malfunction. 

1 The EDITOR failed in writing onto a 

device; generally a hardware 

malfunction. 

2 A file close error occurred. The output 
file could not be closed; either the 
cassette reached an end-of-tape 
condition, or a sentinel file needs to 
be written before any new output files 
can be created on the cassette. 
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A ? occurs any time the EDITOR encounters a syntax error. In 

addition, the following error message may be printed by the EDITOR; 

Message Meaning 

UNIT HAS OPENED FILE Two files cannot be open on the same 

device at the same time. 

During the editing of a file, the output cassette specified in the 
command string may become full before the editing process is 
completed. If this is the case and further writing is attempted on 
that cassette, an error occurs. The output file is closed and the 
message: 

FULL^QUTPUT FILE- 


is printed. The user must now indicate a new output cassette and file 
which will contain the text that would not fit on the first cassette 
and euiy further editing the user wishes to do. Since the contents of 
the text buffer are retained through this procedure, no text will be 
lost if this error occurs. 

NOTE 

If no output file is specified when this 
condition occurs , the EDITOR again 
requests cin output file; this continues 
until the output designation is 
correctly specified. 


Assioming the new output device is valid, the EDITOR will continue the 
operation which filled the old file, putting all output into the new 
output file. After editing is completed, the output files should be 
combined using the EDITOR, The entire process may then appear as 
follows ; 


EDIT 

»1NPUT F1LE- 0;IN 
^OUTPUT FILE- 1: OUT 

#Y 

SSTRING* 

FULL ^OUTPUT FILE-2 ; OUTEWP 

#.L 

TAD STRING 

#.D 

#E 


Device 1; is full. 

2: is specified as the 
new output device 
and editing continues. 


3-22 



At this point the output "file" is 2 files — ItOUT, 2sOUTEMP. When 
output is split like this, the split may have occurred in the middle 
of a line. Therefore, the output files should never be edited 
separately as the split lines will then be lost. In a case such as 
this, the files should be combined with the EDITOR as follows: 


_.R EDIT/M 
♦INPUT F1LE“ 1:QUT 
♦ OUTPUT FILE’ ‘3;QUT 

IE 

♦INPUT FILE-2:0UTEMP 
♦INPUT FILE- 


The new file, OUT, may then be edited. 
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3.10 EDITOR DEMONSTRATION RUN 

The following example illustrates both the use of the EDITOR to create 
a new file and a few of the commands available for editing. Sections 
of the printout are coded by letters which correspond with the 
explanations following the example. 


EDIT 

»INPUT FILE- 

^OUTPUT FILE-0:PROG,PAL 


B 

C 

D 

E 

F 


CHRPUT,0 


SNA 

JMP 1 CHRPUT 
CDF 0 
DCA SHELF 
TAD WIXHATI 
SP c 

JMP PUT#1 
SNA CLO 
JMP PUT#2 
CM A 

DCA WHATl 

#.-3S 

SNA CL0\A 

#.L 

SNA CLA 

#P 
#K 
# A 

TAD SHELF 
AND (360 
CLL RTL 


/ACCEPTS CHAR IN AC AND 
/PACKS IT INTO OUTPUT BUFFER 
/IGNORES NULL 


I 


J 



f R ED I T 

J »INPUT FILE- Ot PROG. PAL 
1 ^OUTPUT FILE- 1 : PROG. PAL 



K 



SPC\A 
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The user calls the EDITOR; the output 
file will be called PROG. PAL and will be 
stored on the default d€‘vice — cassette 
drive 0. There is no input file since 
one will be created from the console 
terminal keyboard. The Append command 
is used to insert text into the empty 
buffer. 

Text is inserted. 

The user makes a mistake and uses the 
RUBOUT key to correct it 

More text is added. 

The user notices a typing mistake he has 
made several lines back in the text. He 
types a CTRL/FORM to finish the Append 
command, searchs for the illegal 
character, corrects it, and then lists 
the line. 

The P command writes the current buffer 
into the output file placing a form feed 
after the last line. The K command 
deletes all text in the current buffer 
in preparation for a new page of text. 

The user inserts new text using the 
Append command. When he is finished he 
types a CTRL/FORM to end the command. 

The user closes the file; control 
returns to the Cassette Keyboard 
Monitor. 

In looking over the listing, the user 
notices another mistake; he opens the 
file, calling it by the same name in 
both the input and output specification 
lines . 

The Intra-Buffer Character String Search 
is used to locate the illegal 
instruction and list it. 

The Single Character Search is used to 
find the letter to be corrected, and the 
RUBOUT key deletes it. 

The file is closed and control again 
returns to the Keyboard Monitor. 




CHAPTER 4 
SYSTEM COPY 


4.1 INTRODUCTION 

The CAPS-8 System Copy (SYSCOP) program allows the user to copy 
individual files or all files from one cassette to another, giving him 
the ability to make multiple copies of a cassette, add files to a 
cassette, auid "clean up" full cassettes so that they may become 
available for future use. System Copy transfers all non-empty files 
on the specified input cassette to the specified output cassette; 
space taken up by previously deleted files (*EMPTY files) is regained. 
(Single file transfers of ASCII files can be performed using the 
CAPS-8 EDITOR; see Chapter 3.) 


4.2 CALLING AND USING SYSTEM COPY 

To call SYSCOP from the System Cassette, the user types; 

. R SYSCOP/Options 

in response to the dot (.) printed by the Keyboard Monitor. 


4.2.1 System Copy Options 

There are three options available for use with System Copy; these 
options are discussed in Table 4-1. (Option usage is explained in 
Chapter 2, Section 2.4.3.) 


Table 4-1 System Copy Options 


Option 


Meaning 


/F This option allows the user to transfer 

individual cassette files from one 
cassette to cuiothcjr. To use the /F 
option, the user responds to the request 
for input specification with the 
cassette drive number euid the name of 
the file to be copied. If the user 
mcikes a typing error while entering the 
input specification, he can type CTRL/U 
to redo the entry. 

/U If the /U option is specified, drive 1 

is zeroed and then drive 0 is copied to 
drive 1. (The /U option is especially 
useful for making copies of the System 
Cassette.) When the /U option is used, 
no further I/O specifications are 
necessary. 

/Z This option causcis the output drive 

(indicated in thes output specification 
line) to be zeroed before any copying 
begins. 
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4.2.2 Input and Output Specifications 

Before indicating the input and output drives to be used for the copy 
operation# the user must ensure that the proper cassettes are mounted. 
The input cassette (the one to be copied) should be write-locked to 
protect the data. The output cassette (the one that will be the new 
copy) should be write-enabled to receive the data. When the input and 
output cassettes are mounted on the correct drives, the user is ready 
to begin the copy operation. 

After SYSCOP has been called from the System Cassette, it asks for the 
input specification as follows: 


IN- 


The user responds with a single digit (0 through 7) specifying the 
input cassette drive number. A carriage return is not necessary. If 
the /F option was used, the user responds to the IN- query with the 
drive number and the name of the file to be copied; in this case, the 
user must also type a carriage return. In the following example, a 
file named ECHO is to be copied from drive 1. 

IN-: ECHO 

After the input specification has been entered. System Copy requests 
the output specification as follows: 


OUT- 

The user responds with a single digit (0 through 7) specifying the 
output drive number. The output drive number cannot be the same as 
the input drive number. If the user wishes to change the input/output 
specifications at this point, he may type a carriage return instead of 
the drive number cifter OUT- to return to the IN- message. 

After both input and output drives have been indicated, the copy 
operation starts. All non-empty files on the input cassette are 
copied, in order, onto the output cassette. (If a file is to be 
copied onto a cassette under the same filename and extension as one 
already present on the cassette, it will still be copied; however, 
future reference to the file will cause the first file under that name 
to be accessed. To circumvent this condition, the user should first 
delete any old files or zero the output cassette.) When all files have 
been copied, control returns to the Keyboard Monitor. 
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Only two responses other than the digits 0 through 7 are accepted in 
reply to the input/output specification messages: carriage return and 
CTRL/C. Carriage return returns the user to the input specification 
message; CTRL/C returns the user to the Keyboard Monitor. Any other 
response is considered illegal. Illegal responses are neither 
accepted nor echoed by System Copy; System Copy simply waits for the 
user to type a legal response. 


4.2.3 System Copy Example 

In this example, the user wishes to make a copy of the System Cassette 
which is mounted on drive 0. One purpose of the copy operation is to 
regain wasted space being taken up by previously deleted files, A 
directory listing shows that the System Cassette currently contains 


the following files : 

C2B00T.BIN 

01/22/73 

MONTOR .BIN 

01/22/73 

SYSCOP.BIN 

01/25/73 

*EMPTY . 


EDIT .BIN 

01/02/73 

PALC .BIN 

01/02/73 

BASIC .BIN 

01/02/73 

♦EMPTY . 


♦EMPTY. 


♦ EMPTY . 


♦EMPTY. 


ABC 

01/22/73 


The user mounts a write-enabled cassette on drive 2 and rewinds the 
tape. He than calls System Copy as follows ; 


.R SYSCOP/Z 


The /Z option will zero the cassette mounted on the cassette drive 
specified in the OUT- message (drive 2) , leaving only the sentinel 
file on the cassette. System Copy then requests the input and output 
drive numbers and the user responds as follows: 


IN> 0 

QUT- 2 


The copy operation starts. If System Copy detects any problems during 
the copy operation, it prints one of the error messages explained in 
Section 4,3. A successful copy operation returns control to the 
Keyboard Monitor. The user can then issue a Directory command to 
ensure that all files were copied correctly. In this example, a 
successful copy operation should produce the following directory 
listing : 


C2B00T.BIN 
MONTOR.BIN 
SYSCOP .BIN 
EDIT .BIN 
PALC .BIN 
BASIC .BIN 
ABC 


01/22/73 

01/22/75 

01/25/73 

01/02/73 

01/02/75 

01/02/73 

01/22/73 
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4.3 SYSTEM COPY ERROR MESSAGES 

Errors which occur during a System Copy operation may be of two types : 
user errors auid cassette errors. User errors may be corrected with 
the appropriate action as detailed in Tadale 4-2. Cassette errors 
normally require the user to use another cassette (for either input or 
output) to complete the copy operation. Control does not return to 
the Keyboard Monitor when a System Copy error occurs. The user may 
use CTRL/C to return to the Monitor if he cannot correct the indicated 
error. 

Table 4-2 System Copy Error Messages 
Message Meaning 

INPUT ERROR ON UNIT n An input error has occurred on the 

cassette drive specified. The user 
should try the copy operation using 
another cassette. 

UNIT n NOT READY There is either no cassette on the 

cassette drive specified or no such 
drive exists. 

UNIT n WRITE LOCKED The user tried to write data when 

the write protect tab of the 
cassette on the drive specified was 
write-locked. 

OUTPUT ERROR ON UNIT n An output error has occurred on the 

cassette drive specified. The user 
should try the copy operation using 
another cassette. 
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CHAPTER 5 
PALC 


5.1 INTRODUCTION 

PALC (an acronym for Program Assembly Language for Cassestte) is an 8K 
2-pass assembler (with an optional third pass) designed for the CAPS-8 
System. A program written in PALC source language is translated by 
the assembler into a binary file in two passes. Pass 1 reads the 
input file and sets up the symbol table; pass 2 reads the input file 
and uses the symbol table created in pass 1 to generate the binary 
(object) file. The binary file may then be loaded into memory using 
the Cassette Keyboard Monitor. 

PALC allows I/O using cuiy CAPS-8 device which handles ASCII text. It 
is called from the System Cassette using the Keyboard Monitor Run 
command, accepts input generated by the CAPS-8 EDITOR, and will 
generate output acceptable for use with both the Monitor Load and Run 
commands . 


5.2 CALLING AND USING PALC 

The user calls PALC from the System Cassette by typing: 

.R PALC/Options 


PALC responds by printing: 

-INPUT FILES 

The user enters his input cassette drive number and filename in answer 
to the asterisk printed by PALC; a total of three input specifications 
are allowed, so that the input interaction may appear as follows: 

-INPUT FILES 
♦ 1 :TaA.PAL 
♦0 :TRB .PAL 
JNI ITHC.PAL 

Usually input files will contain the extension .PAL (see Chapter 2, 
Section 2.2.2), cind PALC will assume this extension unless the user 
explicitly designates another. Thus in the above example the user may 
have responded by typing only 1:TRA, 0:TRB, and 1:TRC, in which case 
PALC would automatically assume euid echo the .PAL extension. 

If the filename contains ein extension other than .PAL, the user must 
specify this extension when entering the input. For example: 


-INPUT FILES 
jtl t FAIL* 1 
ITABLE.ASC 
j»3 t SHOP • 
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In the case of the third input file (SHOR.) an extension is not to be 
indicated. If the user wants to prevent PALC from assuming .PAL, he 
must be sure to include a period in the input line; otherwise PALC 
will append .PAL and look for the filename with that extension. 

If the user does not specify a drive numt)er in his input line, the 
default device — drive 0 — is assumed. PALC will automatically insert 
0: in the input line before echoing the filename as the user has 
entered it. For example: 


♦0 tFLOA.FAL 


The user actually typed only the characters FLOA; PALC assumed both 
the drive number 0 and the .PAL extension and correctly inserted these 
in the I/O line before echoing the complete line. 

A carriage return typed in response to any of the asterisks indicates 
that there are no more input files. 

After the input specifications have been entered, PALC requests the 
binary output as follows: 

-BINArtY FILE 
♦ 

The user responds similarly here by indicating an output drive number 
and filename. Only one binary file is allowed and it should have the 
extension .BIN (since the Monitor Run and Load commands assume this 
extension) . If the user wants his binary file to be called by the 

same name as the first input file he need only type the drive number, 

a colon, and a carriage return. PJUjC will echo this, adding the 
filename with a .BIN extension. For example: 

-INPUT FILES 
_♦! : OPEN. PAL 

-BINARY FILE 
♦0 : OPEN. BIN 

As in the input line, drive 0 and the extension (.BIN) are assumed if 
the user fails to specify them, cind a response of only a carriage 

return indicates that no binary file is to be produced. 

Once the binary output line has been ansv/ered, PTU^jC prints: 

-LIST TO 
♦ 

The user has a choice of sending his output listing to either the 
console terminal or the line printer. To send output to the console 
terminal the user types the characters TTY in response to the asterisk 
as follows : 


-LIST TO 
♦TTY 
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To send output to the line printer, the user responds by typing LPT: 


-LIST TO 
jfeLPT 

A response of a carriage return indicates that no listing is to be 
produced. 

During a PALC assembly only one listing is produced and it may be sent 
to only one device, either the line printer or console terminal, A 
second listing must be produced by anothetr assembly. 

If more cassettes are to be involved in the assembly than the user has 
TU60 unit drives, a certain procedure must be followed during the 
assembly process. For example, assume the user has only one TU60 dual 
cassette unit, and 3 input files are stored on individual cassettes. 
His I/O specification is as follows : 

-INPUT FILES 
*1 : FI .PAL 
_*0 : F2 , PAL 
: F3 , PAL 
-BINARY FILE 
:RESLT.BIM 
-LIST TO 
iLPT 

PALC is a 3-pass assembler, therefore all three input files will be 
referenced 3 times. Assume the user has mounted ItFl.PiUj on drive 1, 
and 0;F2.PAL on drive 0; assembly begins. First the file FI is 
processed, then F2 . After assembly of F2 PALC looks for F3, but since 
the file is on a third cassette which is not mounted, the assembly 
pauses and PALC prints; 


^iOUNT F3»PAL? 


This pause in the assembly allows the user to dismount a cassette and 
replace it with the cassette containing the file F3.PAL. The user 
then responds to the cibove I/O line with the drive number on which he 
has mounted the ncjw cassette (assume 0), as follows: 


^jQUNT F3.PAL7 0 

If the response is valid, PALC responds by typing a CR/LF and 
continues pass 1 of the assembly. (An invalid response causes PALC to 
print a ?; the user may then type the correct response.) 

When pass 1 is completed PALC automatically begins the second pass, 
which creates the binary file. The binary output file specification 
must now be made. Regardless of the output specification indicated in 
the initial dialogue, PALC pauses and asks: 


FOUNT iiESLT.BIN? 
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The user must mount the output cassette which is to contain the binary 
file cuid respond with the drive n\aml:>er on which he has mounted it. 
Assume he decides to mount the cassette on drive 0. He replaces the 
cassette currently on that drive (containing F3.PAL) with the new 
cassette and responds to the command line as follows: 


MOUNT HESLT.BIN? 0 

PALC then opens the binary file on this cassette and prints: 
BINAHY FILE OPENED ON 0 


NOTE 

The cassette used for binary output may 
not contain any of the input files. 
Under no circumstances should the 
cassette containing the binary file be 
removed from the drive until pass 2 is 
completely finished. PAIiC will indicate 
completion of the pass by printing the 
message, "BINARY FILE CLOSED". 


After specification of the binary output file, PALC continues pass 2 
of the assembly by processing the first input file, FI. PAL, currently 
on drive 1. After this file is processed, PALC pauses and asks: 


MOUNT F2.PAL? 


Since the binary file being created on drive 0 is only partially 
complete at this point, the user must not remove the cassette from 
that drive. He must instead remove the cassette from drive 1 and 
replace it with the cassette containing F2,PAL, He then types 1 in 
response to the I/O line cind assembly continues until F3.PAL is 
needed. PALC again pauses cind asks: 


MOUNT F3»PAL? 

Again the user replaces the cassette on drive 1 with the appropriate 
one, correctly answers the I/O line, and assembly continues. 

Once pass 2 is done, pass 3 — the listing pass — must be processed. 
Drive 0 may again be used for input, and assembly of input files 
continues in the same manner as during passes 1 and 2 . 

The procedure of mounting and dismounting cassettes may be repeated as 
many times as necessary until all input files are processed and the 
desired output produced. If an I/O error occurs during any of the 
three passes or if an output cassette becomes full, the user must 
restart the assembly beginning with pass 1. 
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NOTE 


When the assembly is complete, PALC 
prints +C (CTRL/C). The user then 
mounts the system cassette and types 
CTRL/C to return to the Monitor. 


5.2,1 PALC Options 

Table 5-1 lists the options available in PALC which may be indicated 
in the Monitor Run or Load specification line. 


Table 5-1 PALC Options 


Option 

Meaning 

/D 

Generate a DDT-compatible symbol table 
(applicable only if a listing file is 
specified) , 

/H 

Generate non-paginated output. Header, 
page numbers cind page format are 
suppressed (applicable only if a listing 
file is specified) . 

/K 

Used in assembling very large prograims; 
causes system containing 12K or more of 
memory to use fields 2 and up as symbol 
table storage. 

/N 

Generate the symbol table, but not the 
listing (applicable only if a listing 
file is specified; the /H option is 
assumed) . 

/s 

Omit the symbol table normally generated 
with the listing (applicable only if a 
listing file is specified) . 

/T 

Output a carriage return/line feed in 
place of the form feed character (s) in 
the program (applicable only if a 
listing file is specified) . 


5.3 CHARACTER SET 

The following characters are acceptable as input to PALC : 

1. The alphabetic characters: A through Z 

2. The numeric characters: 0 through 9 

3. The characters described in following sections as 
special characters euid operators 
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4. Characters which are ignored during asseinbly such 
as LINE FEED, FORM FEED, and RUBOUT 

All other characters are illegal (except when used in a comment) and 
cause the error message: 


IC AT nnnn 


to be printed during pass 1; nnnn represents the location at which the 
illegal character occurred, (As assembly proceeds, each instruction 
is assigned a location determined by the current location counter (see 
Section 5,7,3), When an illegal character or any other error is 
encountered during assembly, the value of the current location counter 
is returned in the error message,) Illegal characters do not generally 
cause assembly to halt. If an illegal character occurs in the middle 
of a symbol, the symbol is terminated at that point. 


5,4 STATEMENTS 

PALC source programs are usually prepared on the console terminal 
(using the CAPS-8 EDITOR) as a sequence of statements. Each statement 
is written on a single line and is terminated by typing the RETURN 
key. 

There are four types of elements in a PALC statement which are 
identified by the order of their appearance in the statement and by 
the separating (or delimiting) character which follows or precedes the 
element. These are; 

label, instruction operand /comment 

A statement must contain at least one of these elements and may 
contain all four types. The assembler interprets and processes the 
statements, generating one or more binary instructions or data words, 
or performing an assembly process. 


5,4,1 Labels 

A label is the symbolic name created by the programmer to identify the 
location of a statement in the program. If present, the label is 
written first in a statement. It must begin with an alphabetic 
character, contain only alphanumeric characters, and be terminated by 
a comma; there must be no intervening spaces between any of the 
characters and the comma. 


5,4,2 Instructions 

An instruction may be one or more of the mnemonic machine instructions 
or a pseudo-operation which directs assembly processing, (Assembly 
pseudo-ops are described later in this chapter; Appendix C summarizes 
both the mnemonic machine instructions and pseudo-ops used by PALC,) 
Instructions are* terminated with one or more spaces (or tabs if an 
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operand follows) or with a semicolon, slash, or carriage return 
described in Section 5,5.3. 


as 


5.4.3 Operands 

Operands are the octal or symbolic addresses of an asstjmbly language 
instruction or the argument of a pseudo-operator, and can be any 
expression. In each case, interpretation of an operand depends upon 
the instruction or the pseudo-op. Operands are terminated by a 
semicolon, slash, or carriage return. 


5,4.4 Comments 

The programmer may add notes or comments to a statement by separating 
these from the remainder of the line with a slash. Such comments do 
not affect assembly processing or program execution but are useful in 
the program listing for later analysis or debugging. The assembler 
ignores everything from the slash to the next carriage return. (For 
an example see Section 5.5.3, Statement Terminators.) 

It is possible to have only a carriage return on a line, resulting in 
a blank line in the final listing. No error message is given. 


5 . 5 FORMAT EFFECTORS 

The following characters are useful in controlling the format of an 
assembly listing. They allow a neat readable listing to be produced 
by providing a means of spacing through the program. 


5.5,1 Form Feed 

The form feed code causes the assembler to output blank lines in order 
to skip to a new page in the output listing during pass 3; this is 
useful in creating a page-by-page listing. The form feed is generated 
by typing a CTRL/L on the console terminal. 


5.5.2 Tabulations 

Tabulations are used in the body of a source prograrr; to separate 
fields into columns (for details refer to Chapter 3), For example, a 
line written: 


GO, TAD TOTAL/MAIN LOOP 

is much easier to read if tabs are inserted to form: 
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TAD TOTAL 


/MAIN LOOP 


GO, 


5,5.3 Statement Terminators 

The RETURN key is used to terminate a statement and causes a line 

feed/carriage return combination to occur in the listing. The 

semicolon (;) may also be used as a statement terminator and is 

considered identical to a carriage return except that it will not 

terminate a comment. For example: 

TAD A /THIS IS A COMMENT; TAD B 

The entire expression between the slash (/) euid the carriage return is 
considered a comment. Thus in this case the assembler ignores the TAD 

B. 

If, for example, the user wishes to write a sequence of instructions 
to rotate the contents of the accumulator and link six places to the 
right, it might look like the followings 


HTH 

HTH 

HTH 

However, the programmer can alternatively place all three instructions 
on a single line by separating them with the special character 
semicolon (;) euid terminating the entires line with a carriage return. 
The above sequence of instructions can then be written; 


HTH;RTH;HrR 

These multi-statement lines are particularly useful when setting aside 
a section of data storage for use during processing. For example, a 
4-word cleared block could be reserved by specifying either of the 
following; 


LIST, 


or 

LIST^ 0 
0 
0 
0 


0 ; 0 ; 0 


Either format may be used to input data words (data words may be in 
the form of numbers, symbols, or expressions, explained next.) Each of 
the following lines generates one storage word in the object program; 
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DATA> 7777 
A+C -B 

S 

123+82 


5.6 NUMBERS 

Any sequence of digits delimited by either a SPACE, TAB, semicolon, or 
carriage return forms a number. PALC initally interprets numbers in 
octal (base 8) . This base can be changed to decimal using a special 
pseudo-operator (discussed in Section 5.10.2). Numbers are used in 
conjunction with symbols to form expressions. 


5 . 7 SYMBOLS 

A symbol is a string of alphanumeric characters beginning with a 
letter and delimited by a non-alphanumeric character. Although a 
symbol may be any length only the first six characters are recognized; 
since additional characters are ignored, symbols which are identical 
in their first six characters are considered identical. 


5.7.1 Permanent Symbols 

The assembler contains a table (called its permanent symbol table) 
which lists the symbols for all PDP-8 pseudo-op codes, memory 
reference instructions, operate and lOT (Input/Output Transfer) 
instructions. These instructions are symbols which are permanently 
defined by PALC and need no further definition by the user; they are 
summarized in Appendix C. For example: 

HLT This is a symbolic instruction 

assigned the value 7402 by the 
assembler and stored in its permanent 
symbol table. 


5.7.2 User- Defined Symbols 

All symbols not defined by the assembler (and represented in its 
permanent symbol table) must be defined within the source program. 

A symbol may be used as a statement label, in which case it is 
assigned a value equal to the current location counter; it is called a 
symbolic address and can be used as an operand or as a reference to an 
instruction. Permanent symbols (instructions, special characters, and 
pseudo-ops) may not be used as symbolic addresses. 

The following are examples of legal symbolic addresses : 

AODH * 

T0TAL> 

SUM> 

AU 
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The following are illegal symbolic addresses: 


AD>M> 

7ABC> 

LA BEL* 
D+TAG> 
LABEL ^ 


(contains an illegal character) 

(first character must be alphabetic) 

(must not contain imbedded spaces) 

(contains a legal but non-alphanumeric character) 
(must be terminated by a comma with no 
intervening spaces) 


5.7.3 Current Location Counter 

As source statements are processed, PA]jC assigns consecutive memory 
addresses to the instructions and data words of the object program. 
The current location counter contains the address in which the next 
word of object code will be assembled cind is automatically incremented 
each time a memory location is assigned. A statement which generates 
a single object program storage word increments the location counter 
by one. Another statement might generate six storage words, 

incrementing the location counter by six. 

The user sets or resets the location counter by typing an asterisk 
followed by the octal absolute address value in which the next program 
word is to be stored. If the origin is not set by the user, PALC 
begins assigning addresses at location 200. 

*300 /SET LOCATION COUNTER TO 300 

TAG, CLA 

JMP A 
B, 0 

A, DCA B 


The symbol TAG (in the preceding example) is assigned a value of 0300, 
the symbol B a value of 0302, and the symbol A a value of 0303. If a 
symbol is defined more than ’once in this manner, the assembler will 
print the illegal definition diagnostic: 

ID address 

where address is the value of the location counter at the second 
occurrence of the symbol definition. The symbol is not redefined. 
(For aui explanation of diagnostic messages refer to Section 5.14 PALC 
Error Conditions.) For example: 


START, 

><c300 

TAD 

A 


DCA 

COUNTER 

CONTIN, 

JMS 

LEAVE 


JMP 

START 

A, 

-74 


COUNTER, 

0 


START, 

CLA 

CLL 
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The symbol START would have a value of 0300, the symbol CONTIN would 
have a value of 0302, the symbol A would have a value of 0304, the 
symbol COUNTER (considered COUNTE by the assembler) would have a value 
of 0305. When the assembler processed the next line it would print 
(during pass 1) : 


IR COU^JTE+0001 


Since the first pass of PALC is used to define all symbols, the 
assembler will print a diagnostic during pass 2 if reference is made 
to an undefined symbol. For example: 

*71 70 

A, TAD C 

CLA CMA 
HIT 

JMP A I The dollar sign must terminate 

Cf ^ all PDP-8 assembly programs. 

$ 

This would produce the undefined symbol diagnostic: 

US A+0003 


5.7.4 Symbol Table 

Initially, the assembler's symbol table contains the mnemonic op-codes 
of the machine instructions and the assembler pseudo-op codes as 
listed in Appendix C; this is its permanent symbol table. As the 
source program is processed, user-defined symbols along with their 
binary values are added to the symbol table. The symbol table is 
listed in alphabetical order at the end of pass 3. 

During pass 1, if PALC detects that the symbol table is full (in other 
words, there is no more memory space in which to store symbols and 
their associated values) , the symbol table exceeded diagnostic is 
printed : 


SE address 

The assembler then prints +C and waits for a response from the user. 
By typing f C the user can return control to the Monitor. If the 
system contains more than 8K of memory, the user may choose the /K 
option with the Run command (see Section 5.2.1), or more address 
arithmetic may be used to reduce the numlier of symbols. It is also 
possible to segment a program and assemble the segments separately, 
taking care to generate proper links between the segments, (See 
Section 5,11.) PALC's symbol capacity is 768 symbols. The permanent 
symbol table contains 69 symbols, leaving space for 699 possible 
user-defined symbols. Each additional 4K allows 768 new symbols. 

Section 5,10.12 provides instructions concerning altering PALC's 
permanent symbol table should the user wish to add instructions more 
suited to his programming needs. 
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5.7.5 Direct Assignment Statements 

The programmer may insert new symbols with their assigned values 
directly into the symbol tcible by using a direct assignment statement 
of the form: 


SYMBOL=VALUE 

VALUE may be a number or expression. No spaces or tabs may appear 
between the symbol to the left of thes equal sign and the equal sign 
itself. The following are examples of direct assignment statements: 

A:6 

EXiTrJMP I 0 
C=A+B 

All symbols to the right of the equal sign must be already defined. 
The symbol to the left of the equal sign is subject to the same 
restrictions as a symbolic address , and its associated value is stored 
in the user’s symbol teible. The use of the equal sign does not 
increment the location counter; it is, rather, an instruction to the 
assembler itself. 

A direct assignment statement may also equate a new symbol to the 
value assigned to a previously defined symbol. In this case, the two 
symbols share the same memory location. 


DETAzl7 

GAMMArBETA 

The new symbol, GAMMA, is entered into the user's symbol table with 
the value 17. 

The value assigned to a symbol may be changed as follows: 

ALPHAr5 

ALPHA=7 


The second line of code shown changes the value assigned to ALPHA from 
5 to 7. (This is legal but will generate an RD error message, 
explained below.) 

Symbols defined by use of the equal sign may be used in any valid 
expression. For example: 


*200 

A=100 /DOES NOT UPDATE CLC 

Bz400 /DOES NOT UPDATE CLC 

A+B /THE VALUE 500 IS ASSEMBLED AT LOG. 200 

TAD A /THE VALUE 1200 IS ASSEMBLED AT LOC. 201 


If the symbol to the left of the equal sign has already been defined, 
the redefinition diagnostic: 


RD address 

will be printed as a warning, where address is the value of the 
location counter at the point of redefinition. The new value will be 
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stored in the symbol table; for example: 


CLA=7600 

will cause the diagnostic: 


HD -1-0200 

Whenever CLA is used after this point, it will have the value 7600, 


5.7.6 Symbolic Instructions 

Symbols used as instructions must be predefined by the assembler or 
the progrcimmer. If a statement has no label, the instructions may 
appear first in the statement and must be terminated by a space, tab, 
semicolon, slash, or carriage return. The following are examples of 
legal instructions: 

TAD (a mnemonic machine instruction) 

PAGE (an assembler pseudo-op) 

ZIP (an instruction defined by the user) 


5,7,7 Symbolic Operands 

Symbols used as operands normally have a value defined by the user. 
The assembler allows symbolic references to instructions or data 
defined elsewhere in the program. Operands may be numbers or 
expressions. For example: 


TOTALS TAD AC I * TAG 

The values of the two symbols ACl cuid TAG (already defined by the 
user) are combined by a 2's complement add (see Section 5,8,1, 
Operators) . This value is then used as the address of the operand. 


5,7.8 Internal Symbol Representation For PALC 

Each permanent and user-defined symbol occupies four words in the 
symbol table storage area, A PDP-8 instruction has an operation code 
of three bits as well as an indirect bit, a page bit, and seven 
address bits. The PALC assembler distinguishes between pseudo-ops, 
memory reference instructions, other permanent symbols, and 
user-defined symbols in the symbol table. 
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5.8 EXPRESSIONS 


Expressions are formed by the combination of symbols, numbers, and 
certain characters called operators, v/hich cause specific arithmetic 
operations to be performed. An expression is terminated by either a 
comma, carriage return, or semicolon. 


5.8.1 Operators 


There are seven characters in PALC which act as operators: 


+ Two's complement addition 

Two's complement subtraction 
i Multiplication (unsigneid, 12-bit) 
% Division (unsigned, 12-bit) 

! Boolean inclusive OR 

& Boolean AND 

SPACE Treated as a Boolean inclusive OR 

except in a memory ref€;rence 
instruction 


Two's complement addition and subtraction are explained in detail in 
Chapter 1 of INTRODUCTION TO PROGRA^IMING? the user should refer to 
that handbook if he wishes more information. No checks for overflow 
are made during assembly, and any overflow bits are lost from the high 
order end. For example; 

7755+24 will give a result of 1 

The operators + and - may be used freely as prefix operators. 

Multiplication is accomplished by repeated addition. No checks for 
sign or overflow are made. All 12 bits of each factor are considered 
as magnitude. For example: 

3000^^2 wall give a result of 6000 

Division is accomplished by repeated subtraction. The number of 
subtractions which are performed is the quotient. The remainder is 
not saved and no checks are made for sign. Division by 0 will 
arbitrarily yield a result of 0. For example: 

7000%1000 will yield a result of 7 

This could be written as : 


- 1000%1000 

in this case the answer might be expected to be -1 (7777) , but all 12 
bits are considered as magnitude and the result is still 7. 

Use of the multiplication cind division operators requires an attention 
to sign on the part of the programmer beyond that which is required 
for simple addition cind subtraction. The following table of excimples 
is given for reference. 
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Tcible 5~2 Use of Operators 


Expression 

Also written as; 

Result 

7777+2 

-1+2 

+1 

7776-3 

-2-3 

7773 or -5 

0+2 


0 

2+0 


0 

1000+7 


7000 or -1000 

0%12 


0 

12%0 


0 

7777%! 

-1%1 

7777 or -1 

7000%1000 

-1000%1000 

7 

1%2 


0 


The ! operator causes a Boolean inclusive OR to be performed bit by 
bit between the left-hand term and the right-hand term. (The 
inclusive OR is explained in Chapter 1 of INTRODUCTION TO 
PROGRAMMING.) For example; 


if A=1 and B=2 
then A!B=0003 

The & operator causes a Boolean AND to be performed bit by bit between 
the left and right values. The operation is the same as that 
indicated by the memory reference instruction AND. 

SPACE has special significance depending on the context in which it is 
used. When it is used to separate two permanent symbols or two 
user-defined symbols, as in the following example: 


SMA CLA 

it causes an inclusive OR to be performed between them. In this case, 
SMA=7500 and CLA=7600. The expression SMA CLA is assembled as 7700. 
When SPACE is used following pseudo-operators and memory reference 
instructions, it merely delimits the syirbol. 

User-defined symbols are treated as operate instructions. For 
example ; 


A»333 
♦222 
B> CIA 

Possible expressions and their values using the symbols just defined 
are shown below. Notice that the assemtiler reduces each expression to 
one 4-digit (octal) word; 


A 

0333 

B 

0222 

A+B 

0555 

A-B 

0111 

-A 

7445 

1-B 

7557 

B-1 

0221 

Al B 

0333 

-71 

7707 


(an inclusive OR is performed) 
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If the information generated is to be loaded, the current location 
counter is incremented. For example: 


b-7;a+4;a-b 

produces three words of information; the current location counter is 
incremented after each expression. The statement: 


HALT^HLT CLA 

produces no information to be loaded (it produces an association in 
the symbol table) and hence does not increment the current location 
counter. 

*4721 

TEMP, 

TEM2, 0 

The location counter is not incremented after the line TEMP,; the two 
symbols TEMP and TEM2 are assigned the same value, in this case 4721. 

Since a PDP-8 instruction has an operation code of three bits as well 

as cm indirect bit, a page bit, and seven address bits, the assembler 

must combine memory reference instructions in a manner somewhat 

differently from the way in which it combines operate or lOT 

instructions. The assembler differentiates between the symbols in its 
permanent symbol table and user-defined symbols. The following 
symbols are used as memory reference instructions: 


AND 

0000 

Logical AND 

TAD 

1000 

Two's complement addition 

ISZ 

2000 

Increment and skip if zero 

DCA 

3000 

Deposit and clear accumulator 

JMS 

4000 

Jump to subroutine 

JMP 

5000 

Jump 


When the assembler has processed one of these symbols, the space 
following it acts as an address field delimiter. 

*4100 
JMP A 

A, CLA 

A has the value 4101, JMP has the value 5000, and the space acts as a 
field delimiter. These symbols are represented as follows: 

A 100 001 000 001 

JMP 101 000 000 000 

The seven address bits of A are taken, e.g.: 

000 001 000 001 

The remaining bits of the address are tested to see if they are zeros 
(page zero reference) ; if they are not, the current page bit is set: 
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000 oil 000 001 


The operation code is then ORed into the JMP expression to form; 

101 011 000 001 

or, written more concisely in octal: 

5301 

In addition to the above tests , the page bits of the address field are 
compared with the page bits of the current location counter. If the 
page bits of the address field are nonzero and do not equal the page 
bits of the current location counter, an out-of-page reference is 
being attempted and the assembler will take action as described in 
Section 5.11, Link Generation cind Storage. 


5.8.2 Special Characters 

In addition to the operators described in the previous section, PALC 
recognizes several special characters which serve specific functions 
in the assembly process. These characters are: 

= equal sign 
, comma 
* asterisk 
. dot 

” double quote 
( ) parentheses 
[] square brackets 
/ slash 
; semicolon 
<> angle brackets 
$ dollar sign 

The equal sign, comma, asterisk, slash, and semicolon have been 
previously described. The remainder will be described next. 

The special character dot (.) always has a value equal to the value of 
the current location counter. It may be used as any integer or symbol 
(except to the left of an equal sign) , and must be preceded by a space 
when used as an operand. For excimple: 

* 20 ^ 

JMP .+2 

is equivalent to JMP 0202. Also, 

♦300 
• •»'2400 

will produce in location 0300 the quantity 2700. Consider; 


♦2200 

CALL«JMS I • 
0027 
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The second line (CALL=JMS I.) does not increment the current location 
counter,' therefore, 0027 is placed in location 2200 and CALL is placed 
in the user's symbol table with an associated value of 4600 (the octal 
equivalent of JMS I) , 

If a single character is preceded by a double quote (”) , the 8-bit 
value of ASCII code for the character is used rather than interpreting 
the character as a symbol (ASCII codes are listed in Appendix A) . For 
example : 

CLA 

TAD ("A 

The constant 0301 is placed in the accumulator. 

The code : 


will be assembled as 0256, The character must not be a carriage 
return or one of the characters which is ignored on input (discussed 
at the end of this section) . 

Left and right parentheses () enclose a current page literal (closing 
member is optional) , 

★ 200 


CLA 

TAD INDEX 
TAD (2) 
DCA I NDEX 


The left parenthesis is a signal to the assembler that the expression 
following is to be evaluated and assigned a word in the constants 
table of the current page. This is the same table in which the 
indirect address linkages are stored. In the above example, the 
quantity 2 is stored in a word in the linkage and literals list 
beginning at the top of the current memory page. The instruction in 
which the literal appears is encoded with an address referring to the 
address of the literal. A literal is assigned to storage the first 
time it is encountered; subsequent reference to that literal from the 
current page is made to the same register. The use of literals frees 
symbol storage space for variables and makes programs much more 
readable. 

If the programmer wishes to assign literals to page zero rather than 
to the current page, he may use square brackets, [and! , in place of 
parentheses. This enables the programmer to reference a single 
literal from any page of memory. For example: 

★ 200 

TAD [2] 


* 500 

TAD [2] 
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The closing member is optional. Literals may take the following 
forms: constant term, variable term, instruction, expression, or 

cinother literal. 

NOTE 

Literals can be nested, for example: 

=♦^200 

TAD (TAD (30 

This type of nesting may be continued in 
some cases to as many as 6 levels, 
depending on the number of other 
literals on the page and the complexity 
of the expressions within the nest. If 
the limits of the assembler are reached, 
the error messages BE (too many levels 
of nesting) or PE (too many literals) 
will result. 


Angle brackets are used as conditional delimiters. The code enclosed 
in the angle brackets is to be assembled or ignored contingent upon 
the definition of the symbol or value of the expression within the 
angle brackets. (The IFDEF, IFl^JDEF, IFZERO, and IFNZRO 
pseudo-operators are used with angle brackets and are described in 
Section 5,10.9.) 

The dollar sign character ($) is mandatory at the end of a program and 
is interpreted as cin unconditional end-of-pass. It may however occur 
in a text string, comment or " term, in which case it is interpreted 
in the same manner as any other character. 

The following characters are handled by the assembler for the pass 3 
listing, but are otherwise ignored: 

FORM FEED Used to skip to a nev/ page 

LINE FEED Used to create a line spacing without causing a 

carriage return 

RUBOUT Used by the EDITOR to allow corrections in the 

input file. 

Nonprinting characters include: 

SPACE 

TAB 

RETURN 

These characters are used for format control and have been previously 
explained in Section 5,5. 
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5 . 9 INSTRUCTIONS 


There are two basic groups of instructions: memory reference and 
microinstructions. Memory reference instructions require an operand, 
microinstructions do not. 


5.9.1 Memory Reference Instructions 

In PDP-8 computers, some instructions require a reference to memory. 
They are appropriately designated memory reference instructions, and 
take the following format: 


10 11 


OPERATION 
CODE 7 
1 1 



ADDRESS 

1 1 1 1 1 1 


INDIRECT ADDRESSING - 
MEMORY PAGE 


Memory Reference Bit Instructions 


Bits 0 through 2 contain the operation code of the instruction to be 
performed. Bit 3 tells the computer if the instruction is indirect 
(see Section 5.9.2). Bit 4 tells the computer if the instruction is 
referencing the current page or page zesro. This leaves bits 5 through 
11 (7 bits) to specify an address. In these 7 bits, 200 octal (128 
decimal) locations can be specified; the page bit increases accessible 
locations to 400 octal or 256 decimal. For a list of the memory 
reference instructions and their codes, see Appendix C. 

In PALC a memory reference instruction must be followed by a space (s) 
or tab(s), an optional I or Z designation, and any valid expression. 
It may be defined with the FIXMRI instruction as explained in Section 
5.10.12, Altering the Permanent Symbol Table. Permanent symbols may 
be defined using the FIXTAB instruction and may be used in address 
fields as shown below: 

A = 1234 

FIXTAB 

TAD A 


5.9.2 Indirect Addressing 

When the character I appears in a statesment between a memory reference 
instruction cind an operand, the operand is interpreted as the address 
(or location) containing the address of the operand to be used in the 
current statement. Consider: 
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TAD 40 


which is a direct address statement, where 40 is interpreted as the 
location on page zero containing the quantity to be added to the 
accumulator. References to locations on the current page and page 
zero may be done directly. An alternate way to note the page zero 
reference is with the letter Z, as follows: 


TAD Z 40 

This is cin optional notation, not differing in effect from the 
previous example. Thus, if location 40 contains 0432, then 0432 is 
added to the accumulator. Now consider: 


TAD I 40 

which is an indirect address statement, where 40 is interpreted as the 
address of the location containing the quantity to be added to the 
accumulator. Thus, if location 40 contains 0432, and location 432 
contains 0456, then 456 is added to the accumulator. 

NOTE 

Because the letter I is used to indicate 
indirect addressing, it is never used as 
a variable. Likewise the letter Z, 
which is sometimes used to indicate a 
page zero reference, is never used as a 
varicible. 


5.9.3 Microinstructions 

Microinstructions are divided into two groups: operate and 
Input/Output Transfer (lOT) microinstructions. Operate 
microinstructions are further subdivided into Group 1, Group 2, and 
Group 3 designations. 


NOTE 

If a programmer misteikenly specifies an 
illegal combination of micro- 

instructions, the assembler will perform 
an inclusive OR between them; for 
example : 

CLL SKP is interpreted as SPA 
(7100) (7410) (7510) 


Operate Microinstructions 

Within the operate group, there are three groups of microinstructions 
which cannot be mixed. Group 1 microinstructions perform clear, 
complement, rotate and increment operations, and are designated by the 
presence of a 0 in bit 3 of the machine instruction word. 
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0 1 2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

1 1 1 
1 1 

0 

CLA 

CLL 

|cMA 

CML 

■ 

■ 

BSW 

lAC 


ROTATE AC AND L RIGHT ' 

ROTATE AC AND L LEFT 

ROTATE 1 POSITION IF A 0, 2 POSITIONS IF A 1 

(BSW IF BITS 8,9 ARE 0) 

LOGICAL SEQUENCE: 1 -CLA , CLL 2-CMA,CML 

3-IAC 4 -RAR,RAL,RTR,RTL.BSW 


Group 1 Operate Microinstruction Bit Assignments 


Group 2 microinstructions check the contents of the accumulator and 
link and, based on the check, continue to or skip the next 
instruction. Group 2 microinstructions are identified by the presence 
of a 1 in bit 3 and a 0 in bit 11 of the machine instruction word. 


0 1 2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

1 1 1 
1 1 

1 

CLA 

SMA 

SZA 

SNL 


OSR 

HLT 

0 


REVERSE SKIP SENSING OF BITS 5.6.7 IF SET 1 

LOGICAL SEQUENCE: 1 (BIT 8 IS 0) - SMA OR SZA OR SNL 
(BIT 8 IS I ) - SPA AND SNA AND SZL 

2 - CLA 

3- OSR.HLT 

Group 2 Operate Microinstruction Bit Assignments 


Group 3 instructions reference the MQ register. They are 
differentiated from Group 2 instructions by the presence of a 1 in 
bits 3 and 11. The other bits are part of a hardware arithmetic 
option. 


0 1 2 

3 

4 

5 

6 

7 

8 9 10 

1 1 

OPERATION 
CODE 7 

1 1 


CLA 

MQA 


MQL 

1 1 



CONTAINS A 1 TO 
SPECIFY GROUP 3 




KEB-E EXTENDED 
ARITHMETIC 
ELEMENT 


CONTAINS A 1 TO 
SPECIFY GROUP 3 


Group 3 Operate Microinstruction Bit Assignments 


Group 1 and Group 2 microinstructions cannot be combined since bit 3 
determines either one or the other. 
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within Group 2 , there are two groups of skip instructions. They can 
be referred to as the OR group and the AND group. 


OR Group 


AND Group 


SMA 

SZA 

SNL 


SPA 

SNA 

SZL 


The OR group is designated by a 0 in bit 8, and the AND group by a 1 
in bit 8. OR and AND group instructions cannot be combined since bit 
8 determines either one or the other. 

If the programmer does combine Icigal skip instructions, it is 
important to note the conditions under which a skip may occur. 

1. OR Group — If these skips are combined in a statement, 
the inclusive OR of the conditions determines the skip. 

For example: 


SZA SNL 

The next statement is skipped if the accumulator 
contains 0000 or the link is a 1 or both. 

2. AND Group — If the skips are combined in a statement, the 
logical AND of the conditions determines the skip. For 
example : 


SNA SZL 

The next statement is skipped only if the accumulator 
differs from 0000 and the link is 0. 


Input/Output Transfer Microinstructions 

These microinstructions initiate operation of peripheral equipment and 
effect an information transfer betwcien the central processor and the 
Input/Output device (s); i.e., cassettes, console terminal, and line 
printer. The Permanent Symbol Table in Appendix C lists PALC's lOT's. 


5.9.4 Autoindexing 

Interpage references are often necessary for obtaining operands when 
processing large amounts of data. The PDP-8 computers have facilities 
to ease the addressing of this data. When one of the absolute 
locations from 10 to 17 (octal) is indirectly addressed, the contents 
of the location is incremented before it is used as an address and the 
incremented number is left in the location. This allows the 
progrcimmer to address consecutive memory locations using a minimum of 
statements . 



It must be remembered that initially tliese locations (10 to 17 on page 
0) must be set to one less than the first desired address. Because of 
their characteristics, these locations are called autoindex registers. 
No incrementation takes place when locations 10 to 17 are addressed 
directly. For example, if the instruction to be executed next is in 
location 300 and the data to be referenced is on the page starting at 
location 5000 , autoindex register 10 can be used to address the data 
as follows: 

0276 1377 TAD C4777 /:5000-l 

0277 3010 DCA 10 /SET UP AUTO INDEX 

0300 1410 TAD I 10 /INCREMENT TO 5000 

. . , /BEFORE USE AS AN ADDRESS 


0377 4777 C4777,4777 

When the instruction in location 300 is executed, the contents of 
location 10 will be incremented to 5000 and the contents of location 
5000 will be added to the contents of the accumulator. When the 
instruction TAD I 10 is executed again, the contents of location 5001 
will be added to the accumulator, and so on. 


5 . 10 PSEUDO-OPERATORS 

The programmer uses pseudo-operators to direct the assembler to 
perform certain tasks or to interpret subsequent coding in a certain 
manner. Some pseudo-ops generate storage words in the object program, 
other pseudo-ops direct the assembler how to proceed with the 
assembly. Pseudo-ops are maintained in the permanent symbol table. 

The function of each PALC pseudo-op is described below. 


5,10.1 Indirect and Page Zero Addressing 

The pseudo-operators I and Z are used to specify the type of 
addressing to be performed. These have been previously discussed in 
Section 5.9.2. 


5.10.2 Radix Control 

Numbers used in a source program are initially considered to be octal 
numbers. However, the programmer may change or alternate the radix 
interpretation by the use of the pseudo-operators DECIMAL and OCTAL, 

The DECIMAL pseudo-op interprets all following numbers as decimal 
until the occurrence of the pseudo-op OCTAL. 

The OCTAL pseudo-op resets the radix to its original octal base. 
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5.10,3 Extended Memory 

The pseudo-op FIELD instructs the assembler to output a field setting 
so that it may recognize more than one memory field. This field 
setting is output during pass 2 eind is recognized by the Run (or Load) 
command, which in turn causes all subsequent information to be loaded 
into the field specified by the expression. The form is: 

FIELD n 

n is an integer, a previously defined symbol, or an expression within 
the range 0<=n<=7, 

This field setting is output on the binary file during pass 2 followed 
by an origin setting of 200. This word is read when the Run (or Load) 
command is executed and begins loading information into the new field. 

The field setting is never remembered by the assembler and no initial 
field setting is output, A binary file produced without field 
settings will be loaded into field 0 when using the Run (or Load) 
command. 


NOTE 

A symbol in one field may be used to 
reference the same location in any other 
field. The field to which it refers is 
determined by the use of the CDF and GIF 
instructions, (The programmer who is 
unfamiliar with thelOT'sbut wishes to 
use them should refer to the PDP/8E 
SMALL COMPUTER HANDBOOK and experiment 
with several short test programs to 
satisfy himself as to thciir effect.) 

CDF and GIF instructions must be used 
prior to any instruction referencing a 
location outside the current field, as 
shown in the following example; 



★200 



TAD 

P301 


CDF 

00 


GIF 

10 


JMS 

PRINT 


GIF 

10 


JMP 

NEXT 

P301 , 

301 



FIELD 1 


★200 

NEXT, 

TAD 

P302 


CDF 

10 


JMS 

PRINT 


HLT 


P302, 

302 


PRINT, 

0 



TLS 



TSF 
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J'^^p .-1 
CLA 

RDF 

tad P6203 
DCA .+! 

000 

<JMP I PRINT 
P6203, 6203 


When FIELD is used, the assembler follows the new FIELD setting with 
an origin at location 200. For this reason, if the programmer wants 
to assemble code at location 400 in field 1 he must write: 

FIELD 1 /CORRECT EXAMPLE 

^400 

The following is incorrect and will not generate the desired code: 

*400 /INCTORf^ECT 

FIELD 1 


5,10.4 End-of-File 

PAUSE signals the assembler to stop processing the file being read. 
The current pass is not terminated, and processing continues with the 
next file. 

The PAUSE pseudo-op should be used only at the physical end of a file 
and with two or more segments of one program. When a PAUSE statement 
is reached the remainder of the file is ignored and processing 
continues with the next input file. PAUSE must be present or a PH 
error will occur. 


5.10.5 Resetting the Locatioh Counter 

The PAGE n pseudo-op resets the location counter to the first address 
of page n, where n is an integer, a previously defined symbol, or a 
symbolic expression, all whose terms have been defined previously and 
whose value is from 0 to 37 inclusive. If n is not specified, the 
location counter is reset to the next logical page of memory. For 
example : 

PAGE 2 sets the location counter to 00400 
PAGE 6 sets the location counter to 01400 

If the PAGE pseudo-op is used without an argument and the current 
location counter is at the first location of a page, it will not be 
moved. In the following example, the code TAD B is assembled into 
location 00400: 


*377 

PAGE 


.IMP .-3 


TAD B 
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If several consecutive PAGE pseudo-ops are given, the first will cause 
the current location counter to be reset as specified. The rest of 
the PAGE pseudo-ops will be ignored. 


5.10,6 Entering Text Strings 

The TEXT pseudo-op allows a string of text characters to be entered as 
data and stored in 6-bit ASCII by using the pseudo-op TEXT followed by 
a space or spaces, a delimiting character (must be a printing 
character) , the string of text, and the same delimiting character. 
Following the last character, a 6-bit zero is inserted as a stop code. 
For example: 


TAG, TEXT/123=*'/ 

The string would be stored as : 


61 62 
63 52 
0000 


5.10.7 Suppressing the Listing 

Those portions of the source program enclosed by XLIST pseudo-ops will 
not appear in the listing file; the code will be assembled, however. 

Two XLIST pseudo-ops may be used to enclose the code to be suppressed 
in which case the first XLIST with no argument will suppress the 
listing, and the second will allow it again. XLIST may also be used 
with an expression as an argument; a listing will be inhibited if the 
expression is equal to zero, or allowed if the expression is not equal 
to zero. 


5.10.8 Reserving Memory 

ZBLOCK instructs the assembler to reserves n words of memory containing 
zeros, starting at the word indicated by the current location counter. 
It is of the form: 


ZBLOCK n 


For example: 

ZBLOCK 40 

causes the assembler to reserve 40 (octal) words. The n may be an 
expression. If n=0 , no locations are reserved. 
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6el0«9 Conditional Assembly PseudO' Operators 

The IFDEF pseudO“Op takes tl>e form: 


IFDEF symbol <30UL'c,€i oode> 

If the symbol indicated is previously defined, the code contained in 
the angle brackets is assembled; if the symbol is undefined, this code 
is ignored. Any number of statements or lines of code may be 
contained in the angle brackets. The format of the IFDEF statement 
requires a single space before and after the symbol. 

The IFNDEF pseudO“Op is similar in form to IFDEF and is expressed: 

IITIDEF symbol < source code> 

If the symbol indicated has not been previously defined, the source 
code in angle brackets is assembled. If the symbol is defined, the 
code in the angle brackets is ignored. 

The IFZERO pseudo“Op is of the form: 

IFZERO expresson <source code> 

If the evaluated (arithmetic or logical) expression is equal to zero, 
the code within the angle brackets is assembled; if the expression is 
non-zero, the code is ignored. Any numl^er of statements or lines of 
code may be contained in the angle brackets. The expression may not 
contain any imbedded spaces and must have a single space preceding and 
following it. 

IFNZRO is similar in form to the IFZERO pseudo- op and is expressed: 

IFNZRO expression < source code> 

If the evaluated (arithmetic or logical) expression is not equal to 
zero, the source code within the angle brackets is assembled; if the 
expression is equal to zero, this code is ignored. 

Pseudo-ops can be nested, for example: 

IFDEF SYM < IFNZRO X2 <...>> 

The evaluation and subsequent inclusion or deletion of statements is 
done by evaluating the outermost pseudo-op first. 


5.10.10 Controlling Binary Output 

NOPUNCH causes the assembler to cease binary output but continue 
assembling code. It is ignored except during pass 2. 

ENPUNCH causes the assembler to resume binary output after NOPUNCH, 
and is ignored except during pass 2. For example, these two 
pseudo-ops might be used where several programs share the same data on 
page zero. When these programs are to be loaded and executed 
together, only one page zero need be output. 



5,10,11 Controlling Page Format 


The EJECT pseudo-op causes the listing to jump to the top of the next 
page, A page eject is done automatically every 55 lines; EJECT is 
useful if the viser requires more frequent paging. If this pseudo-op 
is followed by a string of characters, the first 40 (octal) characters 
of that string will be used as a new hesider line. 


5,10,12 Altering the Permanent Symbol Table 

PALC contains a table of symbol definitions for the PDP-8 and CAPS-8 
peripheral devices. These are symbols such as TAD, DCA, and CLA, 
which are used in most PDP-8 programs. This table is considered to be 
the permanent symbol table for PAIjC; alJ of the symbols it contains 
are listed in Appendix C, 

If the user purchases one or more optional devices whose instruction 
set is not defined among the permanent symbols (for example EAE or an 
A/D converter) , he would want to add the* necessary symbol definitions 
to the permanent symbol table in every program he assembles. 
Conversely, the user who needs more space for user-defined symbols 
would probably want to delete a] 1 definitions except the ones used in 
his program. For such purposes , PALC h£5is three pseudo-ops that can be 
used to alter the permanent symbol table. These pseudo-ops are 
recognized by the assembler only during pass 1, During either pass 2 
or pass 3 they are ignored and have no effect, 

EXPUNGE deletes the entire permanent syrabol table, except pseudo-ops, 

FIXTAB appends all presently defined symbols to the permanent symbol 
table. All symbols defined before the occurrence of FIXTAB are made 
part of the permanent symbol table until the assembler is reloaded. 

To append the following instructions to the symbol table, the user 
generates an ASCII file called SYMS.PAL containing; 


DVI=7407 
CLSKrSl 31 
FIXTAB 


/MULTIPLY 

/DIVIDE 

/SKIP ON CLOCK INTERRUPT 
/SO THAT THESE WON'T BE 

/PRINTED IN THE SYMBOL TABLE 


The ASCII file is then entered in PALC's input designation. The user 
may also place the definitions at the beginning of the source file. 
This eliminates the need to load an extra file. 

Each time the assembler is loaded, PALC's permanent symbol table is 
restored to contain only the permanent symbols shown in Appendix C. 

The third pseudo-op used to alter the permanent symbol table in PALC 
is FIXMRI. FIXMRT is used to define a memory reference instruction 
and is of the form; 

FIXMRI name-- -value 
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The letters FIXMRI must be followed by one space, the symbol for the 
instruction to be defined, am equal sign, and the value; of the symbol. 
The symbol will be defined and stored in the symbol table as a memory 
reference instruction. The pseudo-op must be repeated for each memory 
reference instruction to be defined. For example: 

EXPUNGE 

FIXMRI TADrl00(? 

FIXMRI DCA=3000 

CLAr7200 

FIXTAB 

When the preceding program segment is read into the assembler during 
pass 1, all symbol definitions are deleted and the three symbols 
listed are added to the permanent symbol table. Notice: that CLA is 
not a memory reference instruction. This process can be performed to 
alter the assembler's symbol table so that it contains only those 
symbols used at a given installation or by a given pregram. This may 
increase the assembler's capacity for user-defined symbols in the 
program. 

A summary of the PALC pseudo-ops is provided in Appendix C. 


5.11 LINK GENERATION AND STORAGE 

In addition to handling symbolic addressing on the current page of 
memory, PALC automatically generates links for off-page references. 
If reference is made to an address not on the page where an 
instruction is located, the assembler sets the indirect bit (bit 3) 
and an indirect address linkage will be generated on the current 
memory page. If the off-page reference is already an indirect one, 
the error diagnostic II (illegal indirect) will be generated. For 
example : 

>^2117 

A, CLA 


*2S00 

JMP A 

In the example above, the assembler will recognize that the register 
labelled A is not on the current page (in this case 2600 to 2777) and 
will generate a link to it as follows: 

1. In location 2600 the assembler will place the word 5777 
which is equivalent to JMP I 2777. 

2. In address 2777 (the last available location on the 
current page) the assembler will place the word 2117 (the 
actual address of A) . 

During pass 3, the octal code for the instruction will be followed by 
an apostrophe (') to indicate that a link was generated. 

Although the assembler will recognize and generate an indirect address 
linkage when necessary, the programmer may indicate am explicit 
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indirect address by the pseudo-op I, The assembler cannot generate a 
link for an instruction that is already specified as being as indirect 
reference. In this case, the assembler will print the error message 
II (illegal indirect) . For example: 

*21 1 7 

A, CLA 


*2600 

JMP I A 

The above coding will not work because A is not defined on the page 
where JMP I A is attempted, and the indirect bit is already set. 

Literals and links are stored on each page starting at page address 
177 (relative) and extending toward page address 0 (relative) . 
Whenever the origin is then set to another page, the literal buffer 
for the current page is output. This does not affect later execution. 
There is room for 160 (octal) literals and links on page zero cind 100 
(octal) literals on each other page of memory. 

Literals and links are stored only as far down as the highest 
instruction on the page. Further attempts to define literals will 
result in a PE (page exceeded) or ZE (page zero exceeded) error 
message. 


5.12 CODING PRACTICES 

A neat printout (or program listing, as it is usually called) makes 
subsequent editing, debugging, and interpretation much easier than if 
the coding were laid out in a haphazard fashion. The coding practices 
listed below are in general use, and will result in a readable, 
orderly listing. 

1. A title comment begins with a slash at the left margin. 

2. Pseudo-ops may begin at the left margin; often, however. 


they are 
executable 

indented one 
instructions . 

tab 

stop 

to line 

up with the 

3. Address labels begin at 

the 

left 

margin. 

They are 


separated from succeeding fields by a tabulation. 


4. Instructions, whether or not they are preceded by a 
label field, are indented one tab stop. 

5. A comment is separated from the preceding field by one 
or two tabs (as required) and a slash; if the comment 
occupies the whole line it usually begins with a slash at 
the left margin. 
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5,13 PROGRAM PI^PARATION AND ASSEMBLER OUTPUT 


The following program was generated using the TAB function of the 
CAPS-8 EDITOR and was assembled with PALC. 


*200 

/example of input to the format 


/GENERATOR PROGRAM 
BEGIN, 0 

KCC 

KSF 

JMP .-1 
KRB 

DCA CHAR 
TAD CHAR 
TAD MSPACE 
SNA CLA 
HLT 

JMP BEGIN+2 
CHAR, 0 
MSPACE, -240 
/END OF EXAMPLE 
$ 


/START OF PROGRAM 

/WAIT FOR FLAG 
/FLAG NOT SET YET 
/READ IN CHARACTER 


/IS IT A SPACE? 
/YES 

/NOtINPUT AGAIN 
/TEMPORARY STORAGE 


The program consists of statements and pseudo-ops and is terminated by 
the dollar sign ($) . If the program is large, it can be segmented by 
placing it into several files; this often facilitates t:he editing of 
the source progicim since each section will be physically smaller. 


The assembler initially sets the current location counter to 0200. 
This counter is reset whenever the asterisk (*) is processed. 


The assembler reads the source file for pass 1 cind defines all symbols 
used. 


During pass 2 , the assembler reads the source file and generates the 
binary code using the symbol table equivalences defined during pass 1. 
The binary file that is output may be loaded by the Load command. 
This binary file consists of an origin setting and date: words. 

During pass 3, the assembler reads the source file emd generates the 
code from the source statements. The assembly listing is output in 
ASCII code. It consists of the current locatior, counter, the 
generated code in octal, and the source statement. The 5-digit first 
column is the field number and 4-digit octal address (current location 
counter) ; the 4-digit second column is the assembled object code. The 
symbol table is printed at the end of the pass. The pc:ss 3 output is: 


*200 

0200 

*200 


PALC-Vl 03/08^73 PAGE 



/EXAMPLE OF 

INPUT TCI 

THE FORMAT 



/generator 

PROGRAM 


00200 

0000 

BEGIN, 0 


/START OF PROGRAM 

00201 

6032 

KCC 



00202 

6031 

KSF 


/WAIT FOR FLAG 

00203 

5202 

JMP 

• •1 

/FLAG NOT SET YET 

00204 

6036 

KRB 


/READ IN CHARACTER 

00205 

3213 

OCA 

CHAR 


00206 

1213 

TAD 

char 


00207 

1214 

TAD 

MSPACE 

/IS IT A SPACE? 

00210 

7650 

SNA 

CLA 
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00211 

7402 


HLT 

/YES 


00212 

5202 


JHP BEGIN+2 

/NOJ INPUT 

AGAIN 

00213 

0000 

CHAR, 

0 

/temporary 

STORAGE 

00214 

7540 

MSPACE, 

• 240 





/END OF 
S 

EXAMPLE 




*200 


PALC-Vl 03/08/73 PAGE !•! 

BEGIN 

0200 


CHAR 

0213 


MSPACE 

0214 



5.13.1 Terminating Assembly 

PALC will a) terminate assembly, b) print a fC, and c) wait for the 
user to mount the System Cassette on drive 0 and type ^C, under any of 
the following conditions : 

1. Normal exit — The $ at the end of the source program was 
executed on pass 2 (or pass 3 if a listing is being 
generated) . 

2. Fatal error — One of the following error conditions was 
found and flagged (see the next section) ; 

BE DE DF PH SE 

3. If typed by the user, control turns to the Monitor. 


5.14 PALC ERROR CONDITIONS 

PALC will detect auid flag error conditions and generate error messages 
on the console terminal. The format of the error message is: 

CODE ADDRESS 

where CODE is a 2-letter code which specifies the type of error, and 
ADDRESS is either the absolute octal address where tlie error occurred 
or the address of the error relative to the last symbolic tag (if 
there was one) on the current page. For example, the following code: 


BEG, TAD LBL 
^TAD LBL 
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would produce the error message: 


IC BEG+0001 

since % is an illegal character. 

If at any time PALC prints fC, the user should make certain that the 
System Cassette is mounted on drive 0 and then type + C to return to 
the Monitor. He should examine each error indication to determine 
whether correction is required. 

On the pass 3 listing, error messages are output as 2-character 
messages on the line just prior to the line in wliich the error 
occurred. The following table lists the PALC error codes. Those 
labeled Fatal Error are followed immediately by an effective tC. 

Table 5-3 PALC Error Codes 


Error Code 


Explanation 


BE Two PAL-C internal tables have overlapped. Fatal 
error — assembly cannot continue. 

DE Device error. An error was detected when trying 
to read or write a device. Fatal error — assembly 
cannot continue. 

DF Device full. Fatal error — assembly cannot 

continue. 

IC Illegal character. The character is ignored and 

the assembly continued. 

ID Illegal redefinition of a symbol. An attempt was 

made to give a previously defined symbol a new 
value by means other than the equal sign. The 
symbol is not redefined. 

IE Illegal equals — an equal sign was used in the 

wrong context. Considered a warning and may not 
indicate an error but rather an undefined symbol 
at that point. 

II Illegal indirect — an off-page reference was made. 

IP Illegal pseudo-op — a pseudo-op was used in the 

wrong context or with incorrect syntax. 

IZ Illegal page zero reference — the pseudo-op Z was 

found in an instruction which did not refer to 
page zero. The Z is ignored. 

PE Current non-zero page exceeded — an att;empt was 

mcide to : 
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Table 5-3 PALC Error Codes (Cont'd) 

Error Code Explanation 

1. Override a literal with an instruction 

2. Override an instruction with a literal 

3. Use more literals than the assembler allows on 
that page. 

This can be corrected by decreasing either the 
number of literals on the page or the number of 
instructions on the page. 

PH Phase error — either no $ appeared at the end of 
the program, or < and > in conditional pseudo-ops 
did not match. Fatal error — assembly cannot 
continue. 

RD Redefinition — a permanent symbol has been defined 

with =. The new and old definitions do not match. 
The redefinition is allowed. 

SE Symbol table exceeded — too many symbols have been 
defined for the amount of memory available. Fatal 
error — assembly cannot continue. 

UO Undefined origin — an undefined symbol has occurred 
in an origin statement. 

US Undefined symbol — a syrrbol has been processed 
during pass 2 that was not defined before the end 
of pass 1. 

ZE Page 0 exceeded — same as PE except with reference 
to page 0 . 
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CHAPTER 6 
CASSETTE Bi\SIC 


6 . 1 INTRODUCTION 

Cassette BASIC is an interactive programming language derived from 
Dartmouth BASIC and designed to run under the Cassette Keyboard 
Monitor. The BASIC language is aimed at facilitating communication 
between the user and the computer. The user types his program as a 
series of numbered statements, making use of common English words and 
familiar mathematical notations. Because the BASIC language involves 
learning only a small number of commands, it is a very easy language 
to use. As the user gains familiarity with BASIC, he can add the 
advanced techniques available to perfom more intricate manipulations 
or express a problem more efficiently and concisely. 

Cassette BASIC provides approximately 1.7 to 2K of memory for program 
storage. Important features include 1- and 2-dimensional 
subscripting, user-coded functions, program chaining, use of cassettes 
for program storage, and use of line printer, if available, for 
output . 

Beginning programmers may find a more fundamental approach to BASIC 
language programming in Chapter 1 of THE EDUSYSTEM HANDBOOK. 


6.2 CALLING BASIC (.R BASIC) 

Using the Cassette Keyboard Monitor, BASIC is called from the System 
Cassette by typing: 

BASIC 

When it is first loaded into memory, BASIC asks the user if he will 
use run-time file input and output as follows: 

USING RUN-TIME FILE I /0?(Y OR N) 

The user responds with Y or N followed by a carriage return. Choosing 
the run-time I/O feature leaves the user approximately 1.7K of memory 
for program storage, whereas a response* of N frees the space used by 
the run-time I/O routines and provides an additional . 3K of memory 
(enough for approximately 20-25 statements or 75 variables) . 
Statements associated with the run-time I/O feature are: 

OPEN... FOR INPUT 
OPEN... FOR OUTPUT 
CLOSE 
IF END# 

PRINT# 

INPUT# 

COMMAS 
NO COMMAS 
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If any of these statements are used witbiout the run-time I/O option 
having been chosen during BASIC's initial dialogue, BASIC will print a 
NO FILES ERROR message at run-time. 

BASIC then asks: 

NEW OR OLD- 


The user responds NEW if he intends to create a program at the 
keyboard, and must respond with the name of the new program when BASIC 
requests : 

NEW PROGRAM NAME- 


The program name is typed as a standard system filename (6 characters 
or less) and an optional extension (1 to 3 characters) ; a program name 
is entered even if the user does not intend to save the program for 
future use. (A response of only a carriage return causes BASIC to 
repeat the NEW PROGRAM NAME request. If the user types an ALT MODE in 
response to this request, the name NONAME. BAS is assigned by BASIC.) 
When the new program name has been entered, BASIC indicates that it is 
ready to accept input by issuing a carriage return/line feed 
combination. 

If the user responds OLD to BASIC's initial dialogue, BASIC assumes 
that the program has been previously saved on a cassette and will ask: 

OLD PROGRAM NAME- 

UNIT»(0-7) : 


The user must respond with the correct program name and file extension 
(if any) , and then must specify which cassette unit drive the file is 
stored on. (An incorrect response will return an error message.) When 
this interaction is complete, BASIC will type: 

READY. 


and the user may edit or run his program. 


6.3 NUMBERS 

Cassette BASIC treats all numbers (in both integer and real formats) 
as real, or floating point, numbers. That is, BASIC accepts as input 
any number containing a decimal point and assumes a decimal ppint 
after any integer number entered. 

In addition to integer and real formats, a third format, is recognized 
and accepted by BASIC in order to express numbers outside the range 
.01<=x<1000000. This format is called exponential or E-type notation. 
In this format, a number is expressed as a decimal number times some 
power of 10, as follows: 
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where E represents "times 10 to the power of", A number in 
exponential notation is then read "xx times 10 to the power of n"; for 
example : 


23,4E2 = 23.4*(10 to the power of 2) = 2340 

Data may be input in any one or all three of these forms. Internal 
computations are carried out in floating point (real) format. Results 
of computations within the range .01<=x<1000000 are output as either 
real or integer decimal numbers (whichever is the correct but more 
concise format) ; results outside this range are output in exponential 
format. BASIC handles seven significant digits in normal operation 
and input/output, as illustrated below: 


Value Typed In 

.01 

.0099 

999999 

1000000 


Same Value 
Output By BASIC 

.01 

9.900000E-3 

999999 

l.OOOOOOE+6 


BASIC automatically suppresses the printing of leading and trailing 
zeros in integer and decimal numbers and, as shown above, prints all 
exponential numbers in the form: 

(sign) x.xxxxxx E (+ or -) n 


where x represents the number carried to six decimal places, E stands 
for "times 10 to the power of", and n represents the exponent. For 
example : 


-3 . 470218E+8 , is equal to -347021800 
7.260000E-4 is equal to .000726 


6 . 4 VARIABLES 

A variable in BASIC is a symbol which represents a number and is 


formed by a single letter or 
example : 

Acceptable Variables 
I 

B3 

X 


a letter followed by a digit. For 


Unacceptable Variables 

2C - A digit cannot begin 
a variable 

AB - Two or more letters 

cannot form a variable 
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The user may assign values to variables either by computing the values 
in a LET statement or by inputting the values as data; these 
operations are discussed later. 


6.5 ARITHMETIC OPERATIONS 

BASIC performs addition, subtraction, multiplication, division and 
exponentiation, as well as more complicated operations explained in 
detail later in the chapter. The five operators used in writing most 
formulas are ; 


Symbol Meaning Example 

+ Addition A + B 
- Subtraction A - B 
* Multiplication A * B 
/ Division A / B 
t Exponentiation A + B 


(Raise A to the 
Bth power) 


6.5.1 Priority of Operations 

In any given mathematical formula, BASIC performs arithmetic 
operations in the following order of evaluation: 

1. Parentheses receive top priority. Any expresision within 
parentheses is evaluated before an unpcirenthesized 
expression. 

2. In absence of parentheses, the order of priority is: 

a. Exponentiation 

b. Multiplication and Division (of equal priority) 

c. Addition and Subtraction (of equal priority) 

3. If either 1 or 2 above does not clearly dessignate the 
order of priority, then the evaluation of expressions 
proceeds from left to right. 

The expression AfBiC is evaluated from left to right as follows: 

1. AfB = step 1 

2. (result of step 1) I'C = answer 

The expression A/B*C is also evaluated from left to right since 
multiplication and division are of equal priority: 

1. A/B = step 1 

2. (result of step 1)*C = answer 
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6,5.2 Parentheses and Spaces 

Paren^eses may be used by the programmer to change the order of 
priority (as listed in rule 2 of the previous section) . Since 
expressions within parentheses are always evaluated first, the 
programmer can control the order of evaluation by enclosing 
expressions appropriately. Parentheses may be nested, or enclosed by 
a second set (or more) of parentheses. In this case, the expression 
within the innermost parentheses is evaluated first, and then the next 
innermost, and so on, until all have been evaluated. 

Consider the following example: 

A=7*( <Bt2+4)/X) 


The order of priority is: 


1. Bf2 

2. (result of step l)+4 

3. (result of step 2)/X 

4. (result of step 3) *7 

Parentheses also prevent 
expression is evaluated. 


= step 1 
= step 2 
= step 3 
= A 

to how the 


any confusion or doubt as 
For example: 


A*Btg/7+B/C+Df2 
( (A*BT2)/7)+( (B/C)+Dt2) 


Both of these formulas will be executed in the same way. However, 

most users will find that the second is easier to understand. 

Spaces may be used in a similar manner., Since the BASIC compiler 

ignores spaces, the two statements: 


LET B = Dt2 + 1 
LETB=Dt2+l 


are identical, but spaces in the first statement provide ease in 
reading. 


6.5.3 Relational Operators 

A program may require that two values be compared at some point to 
discover their relation to one another. To accomplish this, BASIC 
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makes use of the following relational operators: 


= equal to 
< less than 
<= less than or 
equal to 


> greater than 
>= greater than or 
equal to 
<> not equal to 


Depending upon the result of the comparison, flow of program execution 
may be directed to another part of the program, or the validity of the 
relationship may cause a value of 0 (indicating a FALSE condition) or 
1 (indicating a TRUE condition) to be assigned to a variable. For 
example: 


15 X = Y<7: 


This statement assigns the value 1 to X if Y is greater than Z. 
Relational operators are used primarily in conjunction with IF and LET 
statements, both of which are later discussed in detail. 

The meaning of the equal sign (=) should be clarified. In algebraic 
notation, the formula X=X+1 is meaningless. However, in BASIC (and 
most computer languages) , the equal sign designates replacement rather 
than equality. Thus, the formula X=X+1 is actually translated: "add 
one to the current value of X and store the new result back in the 
same variable X"; whatever value has previously been assigned to X 
will be combined with the value 1. An expression such as A=B+C 
instructs the computer to add the values of B anc: C and store the 
result in a third varicible A; the variable A is not beiing evaluated in 
terms of any previously assigned value, but only in terms of B and C, 
Therefore, if A has been assigned any value prior to its use in this 
statement, the old value is lost; it is instead replaced by the value 
of B+C, Finally, the equal sign may be used in relational testing as 
illustrated in the previous example. 


6.6 IMMEDIATE MODE 

Commands are available which allow Cassette BASIC to act as a 
calculator — that is, the user types an algebraic exE>ression which is 
to be calculated and BASIC types back the result. This is called 
Immediate Mode since the user is not required to write a detailed 
program to calculate expressions and equations, but cein use BASIC to 
produce results immediately. The commands used in Immediate Mode are 
PRINT, LET and occasionally the FOR-NEXT combination. These are 
explained in the following paragraphs. 


6.6.1 PRINT Command 

The PRINT command is of the form: 

PRINT expression 

BASIC is instructed to compute the value of the expression and print 
the result on the console terminal. The expression is a normal 
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arithmetic expression v/hich may include numbers, variables, arithmetic 
operators, and functions (discussed in Section 6.8.12), A string of 
text may also be printed (see Section 6.8.5 — PRINT), For example: 


PRINT 1/RT8 
5.960464E-08 


6.6.2 LET Command 

Values may be assigned to variables by use of the LET command as 
follows : 

LET variable=expression 

The computer does not type anything in response to this command, but 
computes the expression and assigns the value to the variable. The 
variable may then be used in another computation or may be output 
using the PRINT command. For example: 


LET PI =3. 141 59 

PRINT P1+4T2 
50.26544 


6,6,3 Looping PRINT and LET Commands 

It is possible to include PRINT and LET commands in a loop so that 
variables and results may be stored or printed in a series. Looping 
is accomplished by means of FOR-NEXT statements in which the FOR 
statement sets the limits of the loop and the NEXT statement 
increments the count by 1. The only restriction in Immediate Mode 
looping is that the command and the looping statements must appear on 
one line. This is accomplished by using the backslash (\) character 
to separate multiple statements on a line. (The backslash is produced 
on an LT33 or 35 Teletype by pressing the SHIFT and L keys 
simultaneously. Other types of terminals provide a separate key.) For 
example : 


LET Pl=3. 14159 

FOR 1=1 TO 3\PRINT PltI\NEXT I 

This combination will print the results of 3,14159 to the 1st, 2nd, 
and 3rd powers respectively. 

More information on looping in general is provided in Section 6,8,7, 
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6 . 7 EXAMPLE RUN 


The following Example Run is included at this point as an illustration 
of Cassette BASIC's initial dialogue, the format of a BASIC program, 
the ease in editing and running it, and the type of output that may be 
produced. The user calls in the program AVER from cassette drive 1 
and attempts to run it. Execution is halted by a SYNTAX ERROR at line 
30. The user lists the program, finds the mistake in line 30, and 
also notices a mistake in line 85. He corrects these errors by 
retyping the lines, and then reruns the program. After execution he 
saves the corrected program on drive 1 under the original name. 

Following sections cover the statements and commands used in BASIC 
programming. 


.R BASIC 

USIMG RUN-TIME FILE I/0?(Y OR N)N 

NEW OR OLD-OLD 

OLD PROGRAM NAME-AVER 
UNIT# C0-7) : 1 


HEADY . 


RUN 

HOW MANY STUDENTS > HOW MANY GRADES PER STUDENT ?5^A 
SYNTAX ERROR AT LINE 30 

LIST 

10 REM - PROGRAM TO TAKE AVERAGE OF 
15 REM - STUDENT GRADES AND CLASS GRADES 

20 PRINT "HOW MANY STUDENTS^ HOW MANY GRADES PER STUDENT 
30 INPUT A>1B 
A0 LET 1=1 
50 FOR J=I TO A 
55 LET V=0 

60 PRINT "STUDENT NUMBER =" i J 

75 PRINT "ENTER GRADES" 

76 LET D=J 

80 FOR K=D TO D+(B-1) 

81 INPUT G 

82 LET V=V+G 
85 NEXT L 

90 LET V=V/B 

95 PRINT "AVERAGE GRADE =";V 

96 PRINT 

99 LET Q=Q+V 

100 NEIXT J 

101 PRINT 

102 PRINT 

103 PRINT "CLASS AVERAGE =";0/A 
10A STOP 

1A0 END 



READY 


30 INPUT A >13 
85 NEXT K 
RUN 

HOW MANY STUDENTS > HOW MANY GRADES PER STUDENT ?5^A 
STUDENT NUM13ER = 1 
ENTER GRADES 
?78 
?86 
?88 
?74 

AVERAGE GRADE = 81.5 

STUDENT NUMBER = 2 

ENTER GRADES 

?59 

?86 

?70 

?87 

AVERAGE GRADE = 75.5 


STUDENT NUMBER = 3 
ENTER GRADES 
?58 
?6A 
?75 
?80 

AVERAGE GRADE = 69.25 


STUDENT NUMI3ER = A 

ENTER GRADES 

?88 

?92 

?85 

?79 

AVERAGE 


GRADE =86 


STUDENT NUMBER 

ENTER GRADES 

?60 

?78 

?85 

?80 

AVERAGE GRADE 


= 5 


75.75 


CLASS AVERAGE = 77.6 
READY. 


SAVE 

UNITf? (0-7) : 1 


READY. 
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6.8 BASIC STATEMENTS 


The statements described in this section are used in creating BASIC 
programs. These statements make up the body of the program; they 
perform arithmetic calculations and input and output operations, and 
control the order of program execution. 


6.8.1 Statement Numbers 

An integer number is placed at the beginning of each line in a BASIC 
program. BASIC executes the statements in a program in numerically 
consecutive order regardless of the order in which they have been 
typed. A recommended practice is to number lines by fives or tens, so 
that additional lines may be inserted in a program without the 
necessity of renumbering lines already present, (BASIC programs may 
be created using either the BASIC Editor as described here, or the 
CAPS-8 EDITOR. If the CAPS-8 EDITOR is used, the programmer must make 
certain to type his program in numerically consecutive order, as BASIC 
will not sort it in this case.) 

Multiple statements may be placed on a single line by separating each 
statement from the preceding statement with a backslash (SHIFT/L) , 
This feature is particularly useful since statement numbers require 
space in the symbol table; if unnecessary statement numbers are 
eliminated by use of the backslash, there will be more room for 
program storage. For example; 


10 A=5\B=.8\C=3\PRINT "ENTER DATA” 

All of the statements in line 10 will be executed before BASIC 
continues to the next line. Only one statement number at the 
beginning of the entire line is necessary. However, it should be 
noted that program control cannot be transferred to a statement within 
a line, but only to the first statement of the line in which it is 
contained (see Section 6.8.9, Transfer of Control Statements). 


6.8.2 Commenting the Program (REM) 

The REM or REMARK statement allows the programmer to insert comments 
or remarks into a program without thes€i comments affecting execution. 
The BASIC compiler ignores everything on a line beginning with REM. 
The form is ; 


(line number) REM (message) 

In the Example Run program, lines 10 euxd 15 are REMARK statements 
describing what the program does. It is often useful to put the name 
of the program and information relating to its use at the beginning 
where it is available for future reference. Remarks throughout the 
body of a long program will help later debugging by explaining the 
purpose of each section of code within the program. 
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6.8.3 Terminating the Program (END and STOP) 

The END statement (line 140 in the Example Run program ) , if present, 
must be the last statement of the entire program. The form is: 

(line number) END 

Use of the END statement is optional. If executed, it signals the end 
of the program and BASIC prints: 


READY. 

Variables and arrays are left in an undefined state, thereby losing 
any values they have been assigned during execution. 

The STOP statement is used synonymously with the END statement to 
terminate execution, but while END occurs only once at the end of a 
program, STOP may occur any number of times. The format of the STOP 
statement is: 

(line number) STOP 

This statement signals that execution is to be terminated at that 
point in the program where it is encountered leaving variables in a 
defined state. (Variables will contain the values assigned when the 
statement is encountered.) 


6.8.4 The Arithmetic Statement (LET) 

The Arithmetic (LET) statement is probably the most commonly used 
BASIC statement. It causes a value to be assigned to a variable and 
is of the form: 


(line number) (LET) x = expression 

where x represents a variable, and the cixpression is either a number, 
another variable, or an arithmetic expression. The word 'LET' is 
optional; thus the following statements are treated the saime: 


LET A=AtB+10 let C=F/G 
A=AtB+10 C=F/G 

As mentioned earlier, relational operators may be used in a LET 
statement to assign a value to a varicilile depending upon the validity 
of a relationship. If the statement is FALSE, the value 0 is assigned 
to the variable; if TRUE, the value 1 is assigned. For example: 


100 A=1 

105 B=2 

110 C=A=B 

120 D=A>B 

130 E=A<>B 

1A0 PRINT C^D>E 

150 END 
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Translated, this actually means "let C=1 if A=B (0 otherwise) ; let D=1 
if A>B (0 otherwise)” and so on. Thus, the values of C, D, and E are 
printed as follows : 

RUN 

0 0 1 
READY. 

There is no limit to the number of relationships that may be tested in 
the statement. 


6.8,5 Input/Output Statements 

Input/Output statements allow the user to bring data into a program 
and output results or data at any time during execution. The console 
terminal keyboard, (LT33 Teletype reader and punch units, if present), 
cassettes, and line printer are all available as I/O devices in 
Cassette BASIC. Statements which conti'ol their use are described 
next . 


READ and DATA 

READ and DATA statements are used to input data into a program. One 
statement is never used without the other. The f(Drm of the READ 
statement is; 


(line number) READ xl,x2,...xn 
where xl through xn represent variable names. For examj^le : 

10 READ A>B>C 

A,B, and C are variables to which values will be assigned. Variables 
in a READ statement must be separated by commas. READ statements are 
generally placed at the beginning of a program, but must at least 
logically occur before that point in the program wheire the value is 
required for some computation. 

Values which will be assigned to the variables in a READ statement are 
supplied in a DATA statement of the form; 

(line number) DATA xl,x2,...xn 

where xl through xn represent values. The values must be separated by 
commas and must occur in the same order as the variables which are 
listed in the corresponding READ statement, A DATA statement 
appropriate for the preceding READ statement is; 

73 DATA 1,2,3 

Thus, after executing the READ statement, A=l, B=2, and C=3, 
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The DATA statement is usually placed at the end of a program (before 
the END statement) where it is easily accessible to the programmer 
should he wish to change the values. 

A READ statement may have more or fewer variables than there are 
values in any one DATA statement. The READ statment causes BASIC to 
search all available DATA statements in consecutive line number order 
until values are found for each variatile in the READ. A second READ 
statement will begin reading values where the first stopped. If at 
some point in the program an attempt is made to read data which is not 
present or if the data is not separated by commas, BASIC will stop and 
print the following message on the console terminal: 

DATA ERROR AT LINE XXXX 

where XXXX indicates the line number of the READ statement which 
caused the error. 


RESTORE 

If it should become necessary to use the same data more than once in a 
program, the RESTORE statement will make it possible to recycle 
through the DATA statements beginning with the lowest numbered DATA 
statement. The RESTORE statement is of the form: 

(line number) RESTORE 

An example of its use follows: 

15 READ BiC>D 


55 RESTORE 
60 READ E>F^G 


80 DATA 6>3>4>7>9,2 


100 END 

In this example, the READ statements in lines 15 and 60 will both read 
the first three data values provided in line 80. If the RESTORE 
statement had not been inserted before line 60, then the second READ 
would pick up data in line 80 starting with the fourth value. 

In recycling through data with a RESTORE statement, the programmer may 
use the same varied) le names the second time through the data, or not, 
as he chooses , since the values are being read as though for the first 
time. In order to skip unwanted values, the programmer may insert 
replacement (or dummy) variables. Consider: 
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1 REtM - PROGRAM TO ILLUSTRATE USE OF RESTORE 
20 READ N 

2 5 PRIMT "UALUES OF X ARE:” 

30 FOR 1=1 TO N 
40 READ X 
50 PRINT X> 

60 NEXT I 
70 RESTORE 
185 PRINT 

190 PRINT “SECOND LIST OF X VALUES'" 

200 PRINT "FOLLOWING RESTORE STATEMENT:" 

210 FOR 1=1 TO N 
220 READ X 
230 PRINT X.» 

240 NEXT I 

250 DATA 4>1^2 

251 DATA 3>4 
300 END 

RUN 

VALUES OF X ARE: 

1 2 3 

SECOND LIST OF X VALUES 
FOLLOWING RESTORE STATEMENT: 

4 1 2 

READY. 

The second time the data values are read, the variable X (line 220) 
picks up the value originally assigned to N in line 20, and as a 
result, BASIC prints: 


4 

3 


To circumvent this, the programmer could insert a dummy variable (for 
example, 205 READ Z ) , which would pick up and store the first value, 
but would not be represented in the PRINT statement. In this case the 
output would be the same each time through the list. 


INPUT 

The INPUT statement is used when data is to be supplied by the user 
from the console terminal keyboard while a program is executing, and 
is of the form: 


(line number) INPUT xl,x2,...xn 
where xl through xn represent varicible names. For excumple: 

25 INPUT A^B>C 

This statement will cause the program to pause during execution, print 
a question mark on the console terminal, and wait for the user to type 
three numerical values. The user must separate the values by commas; 
they are entered into the computer by pressing the RETURN key at the 
end of the list. 
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If the user does not insert enough values to satisfy the INPUT 
statement, BASIC prints another question mark and waits for more 
values to be input. When the correct number has been entered, 
execution continues. If too many values are input, BASIC ignores 
those in excess of the required nur±>er. The values are entered only 
when the user types the RETURN key. 


OPEN 

Input and output files may be stored on cassette, and may be accessed 
during run-time (providing the user has chosen the run-time I/O option 
during BASIC's initial loading dialogue). Before an I/O file is 
accessed however, the user must first open it via one of the following 
commands : 


or 


(line number) OPEN "n:xxxx" FOR INPUT 
(line number) OPEN "n:xxxx" FOR OUTPUT 


where n represents the cassette drive numJDer (0-7) , and xxxx is any 
legal filename (6 characters or less, and optional extension of 3 
characters or less) . Input files are created either by using BASIC or 
the CAPS-8 EDITOR (see Section 6.8.6), and must have been previously 
stored on cassette before being accessed. For example, the statement: 

215 OPEN "ItTEST.DAT" FOR INPUT 


opens an input file named TEST.DAT on cassette drive 1. 

Only one input and one output file may be open at any time, and only 
one file — either input or output — may be open on a given cassette 
drive at one time. 


CLOSE 

The CLOSE statement is used to close a currently open output file, and 
is of the form: 


(line number) CL(DSE 

Suceeding OPEN FOR INPUT statements will perform an automatic close on 
a previously open input file; however, the user should take note of 
the following cases: 

1. If the user attempts to open an input file on a cassette 
which is currently open for output, BASIC will return an 
I O ERROR, as the same cassette drive cannot be open for 
both input and output at the same time. 

2. If the user has an input file open on a cassette, and is 
at its end-of-file (that is, a CTRL/Z has been 
detected) , BASIC will allow him to open an output file 
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on the same cassette, since the input file is 
theoretically "closed". However, if the usier has an 
input file open on a cassette and is not at its 
end-of-file, an I O ERROR will occur if he ttien tries to 
open an output file on the same cassette. (See Section 
6.8.9, IF END#, for more information on BASIC's method 
of detecting cin end-of-file.) 

3. If the user tries to open an output file and an output 
file is already open on any cassette, BASIC will return 
a "FILE OPEN ERROR"; before opening a new output file, 
the current output file must be closed. 

A close is automatically performed on both open input and open output 
files by STOP, END and CHAIN statements, as well as by all errors 
detected at run-time. 


INPUT# 

Once an input file has been opened using the open statement, data can 
be called into a program using the INPUT# statement. The form of this 
statement is; 

(line number) INPUT# xl,x2,,,.xn 

where # signifies that the file is stored on cassette under the 
filename and drive number specified in the last "CiPEN,.,FOR INPUT" 
statement; xl through xn represent variable names. 

When the BASIC program reaches the INPUT# statement during execution, 
the data is automatically called into the program from cassette and 
execution continues. INPUT# statements and INPUT statements may be 
interspersed throughout a program. The input file need only be opened 
once before it is referenced. 


PRINT 

The PRINT statement is used to output results cf computations, 
comments, values of variables, or plot points cf a graph on the 
console terminal. The format is; 

(line number) PRINT expression 

When no expression is indicated in the statement line, a blank line is 
output. For example; 

P05 P^INT 
P10 PRINT 


Two blank lines will be output on the console terminal. By using 
certain kinds of expressions and the control characters colon and 
semicolon, the user can create fairly sophisticated formats. 
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In order to print out the results of a computation and the value of a 
variable, the user types the line number, PRINT, and the variable 
name(s) separated by a format control character (in this case, commas) 
as follows; 

5 A=16\B=5\C=4 

10 PRINT A>C+B>SQR(A) 

In BASIC, an output line is formatted into five columns (called print 
zones) of 14 spaces each. The control character comma causes a value 
to be typed beginning at the next available print zone. In the above 
example, the value of A, the sum of A+B, and the square root of A are 
printed in the first three print zones as follows; 


RUN 

16 9 A 

A statement such as in line number 10 in this next example; 


5 A=2 .3\B=21 \C=1 56.75\D=1 .13A\E=23.A 
10 PRINT A,BjC^D^E 

causes the values of the variables to be printed in the same format 
using all five zones; 

RUN 

2.3 21 156.75 1 . 1 3A 23. A 

When more than five variables are listed in the PRINT statement, the 
sixth value begins a new line of output. 

The PRINT statement may also be used to output a message or line of 
text. The desired message is simply placed in quotation marks in the 
PRINT statement as follows; 

10 PRINT "THIS IS A TEST" 

when line 10 is encountered during execution, the following is 
printed; 

THIS IS A TEST 

A message may be combined with the result of a calculation or a 
variable as follows; 

80 PRINT "AMOUNT PER PAYMENT =">R 

Assuming R=344.96, when line 80 is encountered during execution, the 
results are output as ; 

AMOUNT PEP PAYMENT = 3AA.96 

If a number following a printed message is too long to be printed on a 
single line, the number is automatically moved to the beginning of the 
next line. 

It is not necessary to use the standard 5-zone format for output. The 
control character semicolon (;) causes the text or data to be output 
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immediately after the last character printed (separated from that 
character by a space and followed by another space) . If neither a 
comma nor a semicolon is used, BASIC assumes a semicolon. Thus both 
of the following: 

80 PRINT "AMOUNT PER PAYMENT ="R 
80 PRINT "AMOUNT PER PAYMENT ="5R 

result in: 

AMOUNT PER PAYMENT = 344.96 

The PRINT statement can also cause a constant to be printed on the 
console terminal. (This is similar to the PRINT command used in 
Immediate Mode.) For exaimple : 

10 PRINT 1 .234^SQR< 10014) 

causes the following to be output at execution time: 

1*234 100.07 

Any algebraic expression in a PRINT statement is evaluated using the 
current value of the variables. NumJDers are printed according to the 
format discussed in Section 6.3. 

The following example program illustrates the use of the control 
characters comma and semicolon in PRINT statements. The user may also 
wish to refer to Section 6.8.12 for information pertaining to three 
functions available for additional character control — TAB, PUT, and 
GET: 


10 READ A>B>C 

20 PRINT A>B^C>At2>BT2,Ct2 
30 PRINT 

40 PRINT A;B)C;At2JBt2;C t2 
50 DATA 4,5^6 
60 END 

RUN 

4 5 6 16 25 

36 

4 5 6 16 25 36 

READY. 

Another use of the PRINT statement is to combine it with an INPUT 
statement so as to identify the data expected to be entered. As an 
example, consider the following program: 
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10 REM - PROGRAM TO COMPUTE INTEREST PAYMENTS 
20 PRINT "INTEREST IN PERCENT"; 

25 INPUT J 

26 LET J=J/100 

30 PRINT "AMOUNT OF LOAN"; 

35 INPUT A 

40 PRINT "NUMBER OF YEARS"; 

45 INPUT N 

50 PRINT "NUMBER OF PAYMENTS PER YEAR"; 

55 INPUT M 

60 LET N=N*M 

65 LET I=J/M 

70 LET B=l+I 

75 LET R=A*I/( 1 -1/BtN) 

78 PRINT 

80 PRINT "AMOUNT PER PAYMENT =";R 
85 PRINT "TOTAL INTEREST =”;R:t:N-A 

88 PRINT 
90 LET B=A 

95 PRINT " INTEREST APP TO PRIN BALANCE" 

100 LET L=B*I 

110 LET P=R-L 

120 LET B=B-P 

130 PRINT L>P#B 

140 IF B>=RGO TO 100 

150 PRINT B*I>R-B*I 

160 PRINT "LAST PAYMENT ="B*I+B 

200 END 

HUN 

INTEREST IN PERCENT? 9 

AMOUNT OF LOAN72500 

NUMBER OF YEARS? 2 

NUMBER OF PAYMENTS PER YEAH?4 


AMOUNT PER PAYMENT = 344.9617 
TOTAL INTEREST = 2 59.. 6932 


INTEREST 
56.25 
49.75399 
43.1 1 182 
36.32019 
29.37576 
22.27508 
15.01463 
7 . 590824 
LAST PAYMENT 


APP TO PRIN 
288.71 17 
295.2077 
301 .8498 
308.641 5 
31 5.5859 
322.6866 
329.947 
337.3708 
= 344.9608 


BALANCE 
2211 .288 
1916.081 
1614.231 
1305.589 
990.0035 
667.317 
337.3699 


READY. 


As can be noticed in this example, the question mark is grammatically 
useful when several values are to be input by allowing the programmer 
to formulate a verbal question which the input values will answer. 
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PRINT# 


The PRINT# statement is similar to the PRINT statement with the 
exception that data and messages are sent to the current output file 
on cassette rather than to the console terminal. The form of the 
statement is: 


(line number) PRINT# xl,x2,..,xn 

where # signifies that the output will be sent to the cassette drive 
number and filename of the currently open output file ^ and xl through 
xn represent data variables. (The current open file is determined by 
the OPEN FOR OUTPUT statement, as detailed earlier in this section.) 

If the user attempts to save data on a full cassette, RASIC prints an 
error message and returns control to its editing phase. The data 
already output is lost, and the user will have to rerun his program 
using a different output cassette. 


COMMAS and NO COMMAS 


Data stored in an output file on cassette is often called later as 
input by another or the same program. (This is in fact the only 
method of passing data between segments of a chained program.) In 
order to be useid as input, this data must be in the same format as it 
would appear if written in a DATA statement. Cassette BASIC provides 
two statements for formatting this output — COMMAS and NO COMMAS. 

In order to be used as data, individual values must be separated by 
commas; the COMMAS statement inserts a comma after each item of data; 
(unless the COMMAS statement is inserted in the program prior to 
PRINT# statement, data will be output in the foimat illustrated 
earlier under the PRINT statement.) The form is: 


(line niamber) COMMAS 


A NO COMMAS statement will set the format back to its original state. 
The COMMAS and NO COMMAS statements do not affect output on either the 
console terminal or line printer. 


The following example writes out four values in a file called 
"OUT. DAT", reads the values back into memory and prints them on the 
console terminal. 


10 OPEN "1: OUT. DAT” FOR OUTPUT 
15 COMMAS 
20 PRINT# 1J2;3;4 
30 CLOSE 

40 OPEN "1:0UT.DAT” FOR INPUT 
50 INPUT# I^J^K^L 
60 PRINT I^J^K^L 
70 END 


Output appears as follows: 


RUN 

12 3 4 

READY. 


6-20 



The COMMAS statement is not necessary if the user is only sending 
value per line. The preceding example could have been coded 
follows, with the same results: 


one 

as 


10 OPEN "ItOUT.DAT" FOR OUTPUT 
20 FOR 1=1 TO 4 
30 PRINT# I 
40 NEXT I 
50 CLOSE 

60 OPEN "1:0UT.DAT” FOR INPUT 
70 INPUT# I^JjK>L 
80 PRINT I,J,K,L 
90 END 


In this case the file OUT, DAT would appear: 

1 

2 

3 

4 

whereas in the first case it would appear as follows: 

1 ^ 2 > 3>4 

The user must take care when inputting data from cassette files. For 
example, if the file OUT. DAT is in the form: 


1 j 2 j 3 j 4 


and the user attempts to input these values using the following 
statement: 


50 INPUT# I^JjK 

the proper values for I, J, and K will be read, but the rest of the 
line will be lost as far as satisfying any future variables — just as 
it would be lost if these values were input from the console terminal. 
(Refer to the information concerning the INPUT statement in this 
section. ) 


LPT 

The LPT statement is used to generate output on the line printer (if 
one is available) and is of the form; 

(line number) LPT 

By inserting this statement anywhere in a program, all subsequent 
output, with the exception of error messages, will be printed on the 
line printer. The LPT statement is particularly advantageous for 
outputting large amounts of calculated data, as can be seen from this 
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and following examples : 

100 LPT 

110 FOR F=30 TO 60 STEP 3 
120 PRINT F,Fr2 
130 NEXT F 
140 END 

RUN 


30 

900 

33 

1089 

36 

1296 

39 

1521 

42 

1764 

45 

2025 

48 

2304 

51 

2601 

54 

2916 

57 

3249 

60 

3600 


When the END statement is encountered in the program, the output 
device is reset to the console terminal. 


TTY OUT 

The console terminal may be placed under program control so that 
during execution of a program output may be sent alternately between 
the console terminal and the line printer (if one is available on the 
system) , 

Control is originally set with the console terminal. By issuing the 
LPT statement discussed previously, all subsequent output can be sent 
to the line printer. To return control to the console terminal from 
within the program, the statement: 

(line number) TTY OUT 

is inserted. (Cassette I/O always returns control to the last device 
indicated, so that the TTY OUT statement need only be used when the 
line printer is involved.) 

The following program makes use of almost all the available I/O 
devices. The console terminal and line printer output is included. 

5 hem PHOUFIAM TO DEMONSTHATE ALL I/O DEVICES 
10 REM AVAILABLE IN CASSETTE BASIC 
15 REM 

20 PRINT "PROGRAM TO CALCULATE SQUARES AND SQUARE ROOTS" 

25 PRINT 

27 REM GET LOOP LIMITS FROM USER 
30 PRINT "INPUT LOWER LIMIT" 

35 INPUT L 

40 PRINT "INPUT UPPER LIMIT" 

45 INPUT U 

50 PRINT "INPUT STEP" 

55 INPUT S 

57 HEM CREATE A CASSETTE FILE OF SQUARES OF NUMBERS 
60 OPEN "1 :S0UARE.DAT"FOH OUTPUT 
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65 LPT 

66 HEM PRIWT A FORM FEED 0!\J L I iNJEPR I >JTER 
70 T=PDT(ia) 

75 PRINT "TABLE OF NUMBERS AMD THEIR SLVJAHES" 

80 PRINT 

81 PRINT 

82 print " X'S" Xt2" 

83 PRINT 

85 for X = L to 'J step S 
90 PRINT X^XtR 

95 REM ALSO SEND SOHARES TO CASSETTE FIL.E 
100 PRINT# Xt2 

105 NEXT X 

106 CLOSE 

110 T=P0T(12) 

111 TTY ODT 

112 PRINT "TABLE OF SO0ARES COMPLETE" 

113 LPT 

115 PRINT "TABLE OF NUMBERS AND THEIR SOHARE ROOTS" 
120 OPEN "1 :SO''rARE.DAT"FOR INPrJT 

125 print 

126 PRINT 

127 PRINT " X'S" SOR(X)" 

128 PRINT 

130 FOR X=L TO J STEP S 

135 INPJT# J 

136 PRINT J^SOH(J) 

1A0 NEXT X 

150 T=P0T(12) 

155 TTY OHT 

160 PRINT "P!?OGRAM COMPLETED" 

165 END 

RUN 

PROGRAM TO CALCHLATE SO'JAPES AND S0HARE ROOTS 

INP'JT LOWER LIMIT 
?1 

inpot OPPEl^ LIMIT 
?50 

iNPOT STEP 
?1 

table of SOOARES COMPLETE 
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table f)F NUMBERS ANO THtIR SQUARES 


X 




3 

a 

b 

h 

7 

B 

R 


1 

a 

R 

Ih 

as 

3 A 
49 
ha 
A 1 


1 a 


153 / 


4 9 a 4 id 1 

50 asuM 


table OE numbers ano their square routs 

X 50BCX) 

1 1 


4 

a 

9 

3 

1 6 

4 

as 

s 

35 

b 

uR 

7 

hU 

B 

B 1 

9 

1 0 0 

10 

. 


9 


a 4 0 1 

49 

a 5 0 0 

S0 
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NOTE 


If an LT33 Teletype is used as the 
console terminal and it includes a 
reader cind punch, these devices may be 
used for I/O operations at any time; no 
special statement is required. To read 
in data from the reader, position the 
tape over the sprocket wheel; when input 
is required, set the reader to START and 
the tape will begin reading in. To 
punch a tape, set the punch to ON and 
all Teletype output will be punched on 
the punch. Using the paper tape I/O 
devices is, in effect, the same as using 
the Teletype keyboard. Characters will 
be typed on the Teletype keyboard as 
tapes are being read or punched. 


6,8,6 Creating Run-Time Input Files 

Data files stored on cassette and used for input during execution can 
be created either by use of BASIC itself or by use of the CAPS-8 
EDITOR, 

Using BASIC, the programmer creates a program which accepts values 
from the console terminal keyboard and then writes these onto the 
cassette as an output file. Data files consist of consecutive ASCII 
characters. If the useful data in a file is to end before the actual 
end-of-file, the last useful character must be followed by a CTRL/Z, 
(This character is inserted by BASIC when the user closes an output 
file. When later detected during input, BASIC sets an end-of-file 
flag; the user can test an end-of-filc‘ condition by using the IF-END# 
statement,) The COMMAS statement is useid to produce the correct format 
for a data file when more than one value is on a single line. 

The following program illustrates one method of doing this; 

5 REM - PROGRAM TO ACCEPT DATA FROM THE CONSOLE 
10 REM - TERMINAL AND CREATE A RUNTIME INPUT FILE 
20 OPEN ”0: RTIN.DAT" FOR OUTPUT 
25 PRINT "INPUT A>B>C^D"; 

30 INPUT A^B>C^D 
35 COMMAS 
40 PRINT# A>B>C>D 

45 PRINT "INPUT FCI) FOR 1=1 TO 10" 

50 DIM F<10) 

52 REM - COMMAS NOT NEEDED SINCE ARRAY WILL 

53 REM - BE OUTPUT ONE ELEMENT PER LINE 
55 NO COMMAS 

60 FOR 1=1 TO 10 
70 PRINT "F("I")"; 

75 INPUT FCI) 

80 PRINT# FCI) 

85 NEXT I 

90 PRINT "INPUT VWV2,Z" 

95 INPUT \}\>\J2.,Z 

97 REM - COMMAS ARE NEEDED SINCE VW V2 AND Z 
9 3 REM - WILL BE OUTPUT ON THE SAME LINE 
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100 COMMAS 

105 PRIMT# Ol^Oa^Z 

1 10 closp: 

1 1 5 EMD 
RUN 

SAVE 


UiMIT# (0-7) :0 


READY. 

The CAPS-8 EDITOR can also be used to create an input file. The 
EDITOR first asks for input and output devices and filenames; then the 
user types the file using EDITOR commands and making sure the format 
is correct for BASIC. The same data file in the above example can be 
created using the EDITOR as follows; 


^R EDIT 

* INPUT FILE- 

♦OJiVUr EILE- 0 IRf IN.DAT 

J.A 

1 .37>2 .346;. -1 3 .267j -1 .056 
23 

3.56 
1 .436 

38 

9 .026 
23.067 
89 
54 

12.467 

-1 

123>34 567,789 
£L 

1.37, 2. 34 6, -13. 2 67, -1.0 56 
23 

3.56 
1 .436 

38 

9.026 

23.067 

89 

54 

12.467 

-1 

123,34567,789 

#E 
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6.8.7 Loops (FOR, NEXT and STEP) 


A loop is a set of instructions which are repeated over and over 
again, each time being modified in some way until a terminal condition 
is reached. FOR and NEXT statements define the beginning and end of a 
loop; STEP specifies an incremental value. The FOR statement is of 
the form; 

(line number) FOR v=xl TO x2 STEP x3 

where v represents a varicible name, and xl, x2 , and x3 all represent 
formulas (a formula in this case means a numerical value, variable 
name, or mathematical expression), v is termed the index, xl the 
initial value, x2 the terminal value, and x3 the incremental value. 
For example ; 


15 FOR K=2 TO 20 STEP 2 

This loop will be repeated as long as K is less than or equal to 20. 
Each time through the loop, K is incremented by 2 , so the loop will be 
executed a total of 10 times. 

A variable used as an index in a FOR statement must not be 
subscripted, although a common use of loops is to deal with 
subscripted variables using the value of the index as the subscript of 
a previously defined variable (this is illustrated in Section 6.8.8, 
Subscripted Variables) . 

The NEXT statement is of the form; 

(line number) NEXT v 

where v is the index of the FOR loop and signals the end of the loop. 
When execution of the loop reaches the NEXT statement, the computer 
adds the STEP value to the index and checks to see if the index is 
less than or equal to the terminal value. If so, the loop is executed 
again. If the value of the index exceeds the terminal value, control 
falls through the loop to the following statement, with the value of 
the index equaling the value it was assigned the final time through 
the loop. (Note that this method of handling loops varies among other 
versions of the BASIC language.) 

If the STEP value is omitted, a value of +1 is assumed. (Since +1 is 
the usual STEP value, that portion of the statement is frequently 
omitted.) The STEP value may also be a negative number. 

The following example illustrates the use of loops. This loop is 
executed 10 times; the value of I is 10 when control leaves the loop. 
+1 is the assumed STEP value, 

10 FOR 1=1 TO 10 
20 NEXT I 
30 PRINT I 
40 END 

RUN 

10 

READY. 
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If line 10 had been: 


10 FOR 1=10 TO 1 STEP -1 
the value printed by the computer would be 1, 

As indicated earlier, the numbers used in the FOR statement are 
formulas; these formulas are evaluated upon first encountering the 
loop. While the index, initial, terminal and STEP values may be 
changed within the loop, the value assigned to the initial formula 
remains as originally defined until the terminal condition is reached. 
To illustrate this point, consider the previous example. The value of 
I (in line 10) can be successfully changed as follows: 

10 FOR 1=1 TO 10 
15 LET 1=10 
20 NEXT I 

The loop will only be executed once since the value 10 has been 
reached by the variable I and the terminal condition is satisfied. 

If the value of the counter variable is originally set equal to the 
terminal value, the loop will execute once, regardless of the STEP 
value. If the starting value is beyond the terminal value, the loop 
will also execute only once. 

It is possible to exit from a FOR-NEXT loop without the index reaching 
the terminal value. This is known as a conditional transfer and is 
explained in Section 6,8.9. Control may only transfer into a loop 
which has been left earlier without being completed, ensuring that the 
terminal and STEP values are assigned. 


Nesting Loops 

It is often useful to have one or more loops within a loop. This 
technique is called nesting, and is allowed as long as the field of 
one loop (the numbered lines from the FOR statement to the 
corresponding NEXT statement, inclusivcj) does not cross the field of 
another loop. A diagram is the best way to illustrate acceptable 
nesting procedures : 

ACCEPTABLE NESTING UNACCEPTABLE NESTING 
TECHNIQUES TECHNIQUES 

Two Level Nesting 


C 


FOR 

FOR 

EXT 

FOR 

NEXT 

NEXT 


—FOR 

E FOR 
NEXT 
NEXT 
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Three Level Nesting 


FOR 

FOR 

FOR 


FOR 

pFOR 


r-FOR 

L-next 


*-NEXT 

pFOR 


i-^’OR 

l^^ext 


H“NEXT 

^NEXT 

NEXT 

^■NEXT 
NEXT 


A maximum of eight (8) levels of nesting is permitted. Exceeding that 
limit will result in the error message: 

FOR ERROR AT LINE XXXX 

where XXXX is the number of the line in which the error occurred. 


6.8.8 Subscripted Varicibles 

In addition to single variable naimes, B^^SIC accepts another class of 
variables called subscripted variables. Subscripted variables provide 
the programmer with addi tonal computing capabilities for handling 
lists, tables, matrices, or any set of related variables. Variables 
are allowed one or two subscripts. A single letter forms the name of 
the variable, followed by one or two integers in parentheses, 
separated by a comma, indicating the place of that variable in the 
list. Up to 26 arrays are possible in any program (corresponding to 
the letters of the alphabet) , subject only to the eimount of memory 
space available for data storage. For example, a list might be 
described as A (I) where I goes from 1 to 5 , as follows: 

A(l) ,A(2) ,A(3) ,A(4) ,A(5) 

This allows the programmer to reference each of the five elements in 
the list A. A two dimensional matrix A(I,J) can be defined in a 
similar manner, but the subscriped variable A can only be used once 
(i.e., A(I) and A(I,J) cannot be used in the same program). It is 
possible however, to use the same variable name as both a subscripted 
and an unsubscripted variable. That is, both A and A (I) are valid 
variable names for use in the same program. 

Subscripted variables allow data to be input quickly and easily, as 
illustrated in the following program (the index of the FOR statement 
in lines 20, 42 and 44 is used as the subscript) : 

10 REM - PROGRAM DEMOMSTRAT I NG READING 

11 REM - OF S'JRSCRIPTED VARIABLES 

15 DIM A(5)>B(2^3) 

18 PRINT "A(I) WHERE A = 1 TO 5;*’ 

20 FOR I=I TO 5 

25 READ ACI ) 

30 PRINT A(I); 

35 NEXT I 

38 PRINT 

39 PRINT 

A0 PRINT WHERE 1 = 1 TO 2:'* 

41 PRINT '* AND J=1 TO 3:*’ 

42 FOR 1=1 TO 2 
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43 PRINT 

44 FOR 0=1 TO 3 
48 READ B(IjJ) 

50 PRINT R(I>J); 

55 NEXT J 

56 NEXT I 

60 DATA 1>2>3^A>5>6j7^8 

61 DATA 8^7>6> 5>A>3>2^ 1 
65 END 

HON 

A(I) WHERE A=1 TO 5; 
12 3 4 5 

B( I> 0) WHERE 1=1 TO 2: 

AND J=1 TO 3: 

6 7 8 

8 7 6 

hrady. 


DIM 

From the preceding example, it can be seen that the use of subscripts 
requires a dimension (DIM) statement to define the maximum number of 
elements in the array. The DIM statement is of the form; 

(line number) DIM vl(nl), v2(n2,m2) 

where v indicates an array variable name and n and m are integer 
numbers indicating the largest subscript value required during the 
program. For example; 

15 DIM A(6> 10) 

The first element of every array is automatically assiimed to have a 
subscript of zero. Dimensioning A(6,10) sets up room for an array 
with 7 rows and 11 columns. This matrix can be thought of as existing 
in the following form; 

A0,0 A0,1 ... AO, 10 
A1,0 Al,l ... Al,10 
A2,0 A2,l ... A2,10 


• • 

A6,0 A6,l ... A6,10 

and is illustrated in the following program; 
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10 REM - MATRIX CHECK PROGRAM 
15 DIM A(6> 10) 

20 FOR 1=0 TO 6 
22 LET ACI>0)=I 
25 FOR J=0 TO 10 
28 LET A(0^J)=J 
30 PRINT A(I>J); 

35 NEXT J 
A0 PRINT 
45 NEXT I 
50 END 


RUN 

0 12 3 4 

1 0 0 0 0 

2 0 0 0 0 

3 0 0 0 0 

4 0 0 0 0 

5 0 0 0 0 

6 0 0 0 0 


5 6 7 8 9 
0 0 0 0 0 
0 0 0 0 0 
0 0 0 0 0 
0 0 0 0 0 
0 0 0 0 0 
0 0 0 0 0 


10 

0 

0 

0 

0 

0 

0 


READY. 


Notice that a variable assumes a value of zero until another value has 
been assigned. If the user wishes to conserve memory space by not 
making use of the extra variables set up within the array, he should 
set his DIM statement to one less than necessary, i.e. DIM A(5,9). 
This results in a 6 by 10 array which may then be referenced beginning 
with the A (0,0) element. 


More than one array can be defined in a single DIM statement; 


10 DIM A(20)j B(4>7) 

This dimensions both the list A and the matrix B, 

A number must be used to define the maximum size of the array. A 
variable inside the parentheses is not acceptable and will result in 
an error message by BASIC at run-time. The amount of memory not 
filled by the program will determine the amount of data the computer 
can accept as input to the program at ciny one time. In some programs 
a TOO-BIG ERROR may occur, indicating that memory will not hold an 
array of the size requested. In that event, the user should change 
his program to process part of the datci in one run and then chain to 
another section to process the rest (see Section 6.8.10). 


6,8,9 Transfer of Control Statements 

Certain control statements cause the execution of a program to jump to 
a different line either unconditionally or as a result of some 
condition within the program. Looping is one method of jximping to a 
designated point until a condition is met. The following statements 
give the programmer added capcibilities in this area. 
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Unconditional Transfer (GOTO) 

The GOTO (or GO TO) statement is an unconditional statement used to 
direct program control either forward or back in a program. The form 
of the GOTO statement is: 

(line number) GOTO n 

where n represents a statement number. When the logic of the program 
reaches the GOTO statement, the statement (s) immediately following 
will not be executed; instead execution is transferred to the 
statement beginning with the indicated line number. 

The following program never ends; it does a READ, prints something, 
and jumps back to the READ via a GOTO statement. It atempts to do 
this over and over until it runs out of data, which is an acceptable, 
though not adviscible, way to end a program. 


10 REM - PROliRAM EMDIMU WITH ERROR 
11. REM - MESSAGE WHEN! OUT OF DATA 
20 HEAD X 

25 PRINT •’X = ’’X,”XT2 = ”XT2 
30 00 TO 80 

35 DATA 1 ^ 5^ 10> 1 5>20^85 
40 END 

H'JN 

X= 1 Xt2= 1 

X= 5 Xt2= 85 

X= 10 Xt2= 100 

X= 15 XT8= 885 

X= 80 Xt8= 400 

X= 85 XT2= 685 

data ERROR AT LINE 20 
iitADY. 


Conditional Transfer (IF THEN and IF GOTO) 

A program sometimes requires that two values be compared at some 
point; control of program execution may be directed to different 
procedures depending upon the result of the comparison. In computing, 
values are logically tested to see whether they are equal, greater 
than, less than another value, or possibly a combination of the three. 
This is accomplished by use of the relational operators discussed in 
Section 6.5.3. 

IF THEN and IF GOTO statements allow the programmer to test the 
relationship between two formulas (variables, numbers, or 
expressions) , Providing the relationship described in the IF 
statement is true at the point it is tested, control will be 
transfered to the line number specified, or the indicated operation 
will be performed. The statements are of the form; 

(line number) IF vl <relation> v2 GOTO [or THEN] x 
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where vl and v2 represent variable names or expressions, and x 
represents a line number or ein operation to be performed. The use of 
either THEN or GOTO is acceptable. 

The following two examples are equivalent (the value of the varicd>le A 
is changed or remains the same depending upon A's relation to B) : 


100 IF A>B THEN 120 
110 A=AtB-l 
120 C=A/D 


100 IF A<=B THEN A=AtB-l 
110 C=A/D 


IF END# 

The IF END# statement is used to verify an end-of-file condition 
during run-time input. The form of this statement is: 

(line number) IF END# THEN n 

IF END# instructs BASIC to perform a check on the validity of the last 
INPUT# statement referencing the currently open input file; n 
represents a line number or operation to be performed. If an 
end-of-file (CTRL/Z) was detected during the last INPUT# statement, 
BASIC transfers control to the specified line number or performs the 
indicated operation. If an end-of-file was not detected, then no 
operation occurs. For example: 


150 OPEN ”1: VALUE’* FOR INPUT 


200 INPUT# A^B^C 
210 IF END# THEN 530 
21 5 LET X=SGNCA) 

• 

530 PRINT "INPUT FILE--NOT ENOUGH DATA" 
535 STOP 
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In this example the programmer provides his own error message if there 
is an insufficient number of values for his variables. If there are 
two valid numbers remaining in the input file when stcitement 200 is 
reached, then the variables A and B will receive valid input. When 
the program attempts to input a value for C, BASIC will detect an 
end-of-file and return a value of zero for C. As it executes the IF 
END# statement, BASIC will note that it has jus;t reached the 
end-of-file, cind will transfer control to statement number 530, as the 
user intended. 

However, assume that as line 200 is executed there is only one valid 
data value left in the input file. An end-of-file is detected this 
time when BASIC tries to read a value for B; B is set to zero. When 
BASIC attempts to continue reading a value for C, an EOF ERROR will be 
returned (see Section 6.12) and program execution will terminate since 
the user has tried to read past the end-of-file, A good way of 
circumventing this condition is to include both the INPUT# and the IF 
END# statements in a loop and input one value at a time. Using this 
method allows the progreimmer ' s own error message to be printed before 
BASIC is allowed to read past the end-of-file. 


6.8.10 Program Chaining (CHAIN) 

Since Cassette BASIC allows at most only 2K words of memory for 
program storage, it is possible that a program may be too large to fit 
in memory at one time. However, Cassette BASIC compensates for this 
by allowing different segments of a program to be stored on cassette 
and called as needed. Although each program segment isi restricted to 
2K of memory, total program length is effectively unlimited. The form 
of the CHAIN statement is : 

(line number) CHAIN "nrXXXX" 

where n is the cassette drive number, and XXXX is the name of the file 
to be chained to. The CHAIN statement should be the last statement in 
the user's program. When BASIC transfers to the progreim specified in 

the statement, it removes the old program from memory. Data is not 

passed in memory' during the chain, so the user should be careful to 
save any data he will need in an output file. (See Section 

6.8.5 — PRINT#.) The chain automatically closes euiy open output file, 

transfers control to the lowest statement number in the new program, 
and continues execution. 

For excimple, the following section of a program stores some data 
values on an output cassette eind chains to a file callcsd PART2: 


450 OPEN "ItDATA” FOR OUTPUT 
455 COMMAS 

460 PRINT# B>C^D^G^H>Z 
465 NO COMMAS 
470 FOR 1=1 TO 10 
475 PRINT# ACI) 

480 NEXT I 
485 CLOSE 

490 CHAIN "1SPART2" 
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The values stored by this section of the program in the cassette file 
DATA can be read in by the second section of the program — PART2 — and 
can continue to be used. PART2 might appear as follows: 

1 D I M A ( 1 0 ) 

5 OPEN "IrDATA" FOR INPUT 
10 inputs}' B,C^D>G>H>Z 
15 FOR 1=1 TO 10 
20 INPUT# A<I) 

25 NEXT I 


6.8.11 Subroutines (GOSUB and RETURN) 

A subroutine is a section of code performing some operation that is 

required at more than one point in the program. Often a complicated 

I/O operation for a volume of data, a mathematical evaluation which is 

too complex for a user-defined function, or any number of other 

processes may best be performed in a subroutine. 

Subroutines are generally placed physically at the end of a program, 
usually before DATA statements, if any, and always before the END 
statement. Two statements are used exclusively in BASIC to handle 
subroutines; these are the GOSUB and RETURN statements. 

A program begins execution and continues until it encounters a GOSUB 
statement of the form: 

(line number) GOSUB x 

where x represents the first line number of the subroutine. Control 
then transfers to that line. For example: 


50 GOSUB 200 

When program execution reaches line 50, control transfers to line 200, 
and the subroutine is processed until execution encounters a RETURN 
statement of the form: 


(line number) RETURN 

The RETURN statement causes control to return to the statement 
following the GOSUB statement. Before transferring to the subroutine, 
BASIC internally records the next statement to be processed after the 
GOSUB statement; thus the RETURN statement is a signal to transfer 
control to this statement. In this way, no matter how many different 
subroutines are called, or how many times they are used, BASIC always 
knows where to go next. 

The following program demonstrates a simple subroutine: 
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1 REM - THIS PROGRAM ILLUSTRATES GOSUB AND RETURN 
10 DEF FNA<X)=ABS(INT(X) ) 

20 INPUT A>B>C 
30 GOSUB 100 
A0 LET A=FNA(A) 

50 LET B=FNA(B) 

60 LET C=FNA(C) 

70 PRINT 
80 GOSUB 100 
90 STOP 

100 REM - THIS SUBROUTINE PRINTS OUT THE SOLUTIONS 

110 REM - OF THE EQUATION: A(Xt2) + B(X) + C = 0 

120 PRINT "THE EQUATION IS "A"*Xt2 + ”B"*X + "C 

130 LET D=B*B-A*A*C 

1A0 IF D<>0 THEN 170 

150 PRINT "ONLY ONE SOLUTION... X ="-B/(2*A) 

160 RETURN 

170 IF D<0 THEN 200 

180 PRINT "TWO SOLUTIONS... X ="; 

185 PRINT C -B+SQR<D) )/<2*A)"AND X =" ( -B-SQR ( D) ) / ( 2*A ) 

190 RETURN 

200 PRINT "IMAGINARY SOLUTIONS... X = C"; 

205 PRINT “B/(2*A)">"SQR< -D)/(2*A)") AND ("; 

207 PRINT “B/(2*A)","-SQR( -D)/(2*A)")" 

210 RETURN 
900 END 

RUN 

?1> .5^-. 5 

THE EQUATION IS 1 *Xt2 + . 5 ♦X + -.5 

TWO SOLUTIONS... X = .5 AND X =-l 

THE EQUATION IS 1 *Xt2 + 0 *X + 1 

IMAGINARY SOLUTIONS... X = ( 0 ^ 1 ) AND ( 0 »-l :• 

READY. 

Line 100 begins the subroutine. There are several places in which 
control may return to the main program, depending upon the flow of 
control through the various IF statements. The subroutine is called 
from line 30 cind again from line 80. When control returns to line 90, 
the program encounters the STOP statement and execution is terminated. 
It is important to remember that subroutines should generally be kept 
distinct from the main program. The last statement in the main 
program should be a STOP or GOTO statement, and subroutines are 
normally placed following this statement. A useful practice is to 
assign distinctive line numbers to subroutines. For example, if the 
main program is numbered with line numbers up to 199, then 200 and 300 
could be used as the first numbers of two subroutines. 


Nesting Subroutines 

Nesting of subroutines occurs when one subroutine calls another 
subroutine. If a RETURN statement is encountered during execution of 
a subroutine, control returns to the statement following the GOSUB 
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which called it. From this point, it is possible to transfer to the 
beginning or euiy part of a siobroutine, even back to the calling 
subroutine. Multiple entry points and RETURN statements make 
subroutines more versatile. 

The maximum level of GOSUB nesting is about ten (decimal) levels, 
which should prove more than adequate for all normal uses , Exceeding 
this limit will result in the message: 

GOSUB ERROR AT LINE XXXX 

where XXXX represents the line number where the error occurred. An 
example of GOSUB nesting follows. Execution has been stopped by 
typing a CTRL/SHIFT/P combination (see Section 6.11.4, Stopping a 
Run) , as the program would otherwise continue in cin infinite loop. 

10 REM - FACTORIAL PROGRAM USING GOSUB TO 

15 REM - RECURSIVELY COMPUTE THE FACTORS 

A0 INPUT N 

50 IF N>20 THEN 120 

60 X=1 

70 K=1 

80 GOSUB 200 

90 PRINT "FACTORIAL "N" ="X 
110 GO TO 40 

120 PRINT "MUST BE 10 OR LESS" 

130 GO TO 40 
200 X=X*K 
210 K=K+1 

220 IF K<=N THEN GOSUB 200 
230 RETURN 
240 END 


RUN 

?2 

FACTORIAL 2 =2 

?4 

FACTORIAL 4 =24 

?5 

FACTORIAL 5 =120 

7 

STOP. 

READY. 


6.8.12 Functions 

BASIC defines several mathematical calculations for the programmer, 
eliminating the need for tables of trig functions, square roots, and 
logarithms. These functions have a 3-letter call name, followed by an 
argument, x, which can be a number, variaible, expression, or another 
function. Table 6-1 lists the functions available in Cassette BASIC. 
Most are self-explanatory; those that are not and are described in 
greater detail are marked with an asterisk. 
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Function 

SIN(x) 

COS(x) 

TAN(x) 

ATN(x) 

EXP (x) 
LOG(x) 
*SGN(x) 


*INT(x) 
ABS (x) 
SQR(x) 
*RND(x) 
*TAB(x) 
*GET(x) 
*PUT(x) 
*FNA(x) 
*UUF (x) 


Table 6-1 Cassette BASIC Functions 

Meaning 

Sine of x (x is expressed in radians) 
Cosine of x (x is expressed in radians) 
Tangent of x (x is expresseid in radians) 
Arctangent of x (result is expressed 
in radians) 

e to the xth power (e=2.71£282) 

Natural log of x (loggx) 

Sign of x — assign a value of +1 if x is 

positive, 0 if X is zero, or -1 if x 
is negative 
Integer value of x 
Absolute value of x (|x|) 

Square root of x ( /x) 

Random number 

Print next character at space x 
Get a character from input device 
Put a character on output device 
User-defined function 

User-coded function (machine language 
code) 


Sign Function (SGN(x)) 

The sign function returns the value +1 if x is a positive value, 0 if 
X is zero, and -1 if x is negative. For example, SGIJ (3 . 42) =1, 
SGN(-42)=-l, cuid SGN (23-23) =0 . The following example illustrates the 
use of this function; 


10 REM - SGN FUNCTION EXAMPLE 
20 READ A>B 
2 5 PRINT "A=’'A,’*B="3 

30 PRINT "SGNC A) ="SGN( A) >"SGN(B) =”SGNCB) 
40 PRINT "SGiNC INT(A) ) ="SGNC INT(A) ) 

50 DATA -7.32> .44 

60 END 


Integer Function (INT(x)) 

The integer function returns the value of the nearest integer not 
greater than x. For example, INT (34 . 67) =34 , By specifying INT(x+.5) 
the INT function can be used to round numbers to the nearest integer; 
thus, INT (3 4.67+. 5) =3 5. INT can also be used to round numbers to any 
given decimal place by specifying; 

INT(X*10fD+.5) /lOfD 

where D is the number of decimal places desired. The following 
program illustrates this function; execution has been stopped by 
typing a CTRL/SHIFT/P; 
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10 REM - I NT FUNCTION EXAMPLE 
20 PRINT ’’NUMBER TO BE ROUNDED”^ 

30 INPUT A 

A0 PRINT ”NO. OF DECIMAL PLACES”; 

50 INPUT D 

60 LET 3=INT(A+10tD+.5)/10TD 
70 PRINT ”A ROUNDED = ”B 
80 GO TO 20 
90 END 

RUN 

NUMBER TO BE ROUNDED? 55 . 65342 

NO. OF DECIMAL PLACES72 

A ROUNDED = 55.65 

NUMBER TO BE ROUNDED778 .375 

NO. OF DECIMAL PLACES 7 -2 

A ROUNDED = 100 

NUMBER TO BE ROUNDED? 67 . 89 

NO. OF DECIMAL PLACES? -1 

A ROUNDED = 70 

NUMBER TO BE ROUNDED? 

STOP. 

READY. 

If the argument is a negative number, the value returned is the 
largest negative integer (rounded to the higher value) contained in 
the number. For example, INT(-23)=-23 but INT (-14, 39) =-15 . 


Random Number Function (RND(x)) 

The random number function produces a random number n which is in the 
range 0<n<l. The numbers are not reproducible, a fact the programmer 
should keep in mind when debugging or checking his program. The 
argument x in the RND(x) function call can be any number, as that 
value is ignored. The following program illustrates the use of this 
function to generate a table of random numbers. 

10 REM - RANDOM NUMBER EXAMPLE 
25 PRINT ’’RANDOM NUMBERS” 

30 FOR 1=1 TO 30 
40 PRINT RND(0)> 

50 NEXT I 
60 END 


RUN 

RANDOM NUMBERS 


.7759228 

.08069808 

.5008833 

.2790171 

.1661529 

.4857633 

.4192038 

.1433537 

.08728769 

.2335427 

.6156673 

.5921191 

.011 70888 

.741 1813 

.341708 

.3796163 

.2023254 

.7974058 

.9635064 

.6043865 

.9547609 

.2890875 

.1416765 

.2482717 

.2145417 

.05280478 

.3859534 

.8404774 

.5692836 

.8514056 


READY. 
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It is possible to generate random numbers over any range by using the 
following formula: 


(B-A) *RND(0) +A 

This produces a random number (n) in the range A<n<B. For example, in 
order to obtain random digits in the range 0<n<9, line 40 in the 
previous example is changed to read: 


40 PRIMT 9*RND(0)^ 

To obtain random integer digits, the INT function is used in 
conjunction with the RND function (using the Scime values for A and B 
above) as follows: 


40 PRINT INT(9*RND(0) 


When the program is run, the results will look as follows: 


HUN 

RANDOM NUMBERS 
4 
1 
8 
2 
8 
0 

READY. 


5 

0 

3 

4 
7 
7 


8 

7 

0 

7 

1 

0 


1 

8 

8 

7 

8 
7 


8 

5 

8 

4 
2 

5 


Notice that the range has changed to 0<=n<9, This is because the INT 
function returns the value of the nearest integer not greater than n. 


Tab Function (TAB(n)) 

The TAB function allows the user to position the printing of 
characters anywhere on the teleprinter (or line printer) line. Print 
positions can be thought of as being numbered from 1 to 72 across the 
console terminal line (1 to 80 across the line printer line) from left 
to right. The form of this function is: 

TAB(n) 

where the argument n represents the position (from 1 to the total 
number of spaces available) in which the next character will be typed. 
For example, TAB (3) causes the character to be printed at position 3. 

Each time the TAB function is used, positions are counted from the 
beginning of the line, not from the current position of the printing 
head. For example, the following statement: 

10 PRINT "X =:";TAB(3)i’’/**;3.141 59 

will print the slash on top of the equal sign, as shown below: 

RUN 

X ^ 3.14159 
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drawn 


The following is 6Ui example of the sort of graph that can be 
with BASIC using the TAB function: 

30 FOR X=0 TO 15 STEP .5 

40 PRINT TAB(30 + 15*SIN<X)*EXP(-.l*X));"*** 

50 NEXT X 


RUN 



♦ 

♦ 

* 


PUT and GET Functions (PUT(x) , GET(x)) 

Cassette BASIC provides two additional functions, PUT and GET, to 
increase input/output flexibility on the console terminal or line 
printer. Using these statements, the programmer can "PUT" an ASCII 
character on the current output device, or "GET" a character from the 
current input device, (ASCII character codes are listed in Appendix 
A.) GET is of the form: 


GET(x) 

where the argument x is a dummy varicible which may be any value. 
GET(x) will be assigned the decimal value of the ASCII code of the 
next character input on the current input device. 

For excimple, if the following statement appears in a program: 


10 LET L=GET(0) 
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and the next character input is an M, the variable L wi].l be assigned 
the value 77 (decimal). 

PUT is of the form: 


PUT(x) 

where the argument x represents either the decimal value of the ASCII 
code of the character to be output, or the characteir itself. For 
example, the statement: 


15 L=PUT(GETCV) ) 

will wait for a character to be read from the current input device and 
then print it on the current output device. A statement such as: 


30 PRINT PUT<Q) 

will print the character typed as well as the decimal value of the 
ASCII code for that character, (Since both the character and the 
decimal value are typed, PUT and GET statements should not be used 
with cassette files.) 

NOTE 

If the user is inputting characters from 
paper tape via the paper tape reader on 
an LT33 Teletype, he should be careful 
to position the tape on the first 
character to be input. Otherwise blank 
tape may be entered, which is 
interpreted as a "BREAK" and stops a 
running program. 


The PUT function can also be used to format output. For example, to 
print a trig table on the line printer with a heading and 50 data 
lines per page, the form feed character (12 decimal) can be "PUT" to 
the printer as follows: 

100 LPT 

110 GOSUB 1000 
120 GOSUB 500 

125 REM - SET UP TRIG TABLE 
130 FOR J=0 TO 360 STEP .5 
1A0 LET L=L+1 
150 LET B=J/180*3.1A 

160 PRINT J,SIN(B)<COS(B)^TAN(B)^ATNCB) 

165 REM - print 50 ENTRIES IN TABLE 

170 IF L=50 THEN GOSUB 500 

180 NEXT J 

190 GOSUB 1000 

200 GOSUB 1000 

210 STOP 

500 REM - PRINT HEADER 
505 GOSUB 1000 
510 PRINT 
520 PRINT 

530 PRINT "ANGLE" -"S I NE’S”C0S I NE"^"TANGENT"» "ARCTANGENT” 

5A0 PRINT 
550 RETURN 

1000 REM - PRINT FORM FEEDS TO ADVANCE PAPER 
1005 X=PUT(12) 

1010 L=0 
1020 RETURN 
1030 END 
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The beginning of the line printer output from this program follows. 
The first page of the table continues through an angle of 24.5 
degrees : then the header and the next 50 entries are printed on the 


next page, 
.5) for all 

and so on until 
angles through 360 

the values 
degrees . 

have been output 

(in steps of 

angle 

SINE 

COSINE 

TANGENT 

ARCTANGENT 

0 

0 

1 

0 

0 

.5 

8,7221126-03 

,999962 

8,7224446-03 

8,722001E-03 

1 

.01744356 

.9998479 

,01744621 

.01744268 

1.5 

.02616368 

.9996577 

,02617264 

,0261607 

2 

.03468181 

,9993915 

,03490305 

,03487474 

2.5 

,0435972<> 

,9990492 

,04363878 

,0435835 

3 

,05230945 

,9986309 

,05238116 

.05228564 

3.5 

,06101763 

,9981367 

.06113154 

,06097986 

a 

.06972117 

,9975665 

,06989125 

,06966486 

«.5 

.0784194 

,9969205 

,07866164 

.07833935 

5 

.08711167 

,9961986 

,08744408 

,08700204 

5,5 

.09579731 

.9954009 

,09623993 

,09565166 

6 

,1044757 

,9945274 

,1050506 

.1042869 

6.5 

. 1131461 

,9935784 

, 1138774 

, 1129067 

7 

,1218079 

,9925537 

,1227217 

,1215095 

7.5 

.1304604 

,9914535 

,131585 

, 1 300944 

8 

.139103 

,9902779 

.1404687 

.13866 

8,5 

• 

• 

.147735 

,989027 

,1493741 

,1472052 

» 

24,5 

,414496 

,9100512 

,4554645 

,4038923 


FNA' Function (DEF FNA(x)) 

In some programs it may be necessary to execute the same mathematical 
formula in several different pj.aces„ Cassette BASIC allows the 
progrcimmer to define his own function in the BASIC language and then 
call this function in the same manner as the square root or a trig 
function is called. Only one such user-defined function may be 
included per progrcim. The function is defined once at the beginning 
of the program before its first use, and consists of a DEF statement 
in combination with a 3- letter function name, the first two letters of 
which must be FN. The format of the DEF FNA statement is as follows: 

(line number) DEF FNA(x) =formula (x) 

The A in the FNA portion of the statement may be any letter. The 
argument (x) has no significance; it is strictly a dummy variable but 
must be the same on each side of the equal sign. The function itself 
can be defined in terms of numbers, several variables, other 
functions, or mathematical expressions. For example: 


10 DEF FNACX) =Xt2+3*X+4 


or 
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20 DEF FNCCX)=SQR(X+4)+l 


The function: 

10 DEF FNLCS)=St2 
will cause the later statement: 

20 LET R=FNA(4>+1 
to be evaluated as R-17, 

The user-defined function can be a function of only one variable, 

User-Coded Function (UUF) 

The user-coded function is explained in detail in the neixt section. 


6.9 IMPLEMENTING A USER-CODED FUNCTION (UUF) 

A special user-coded function is available in Cassette BASIC for the 
programmer who is familiar with the PDP-8 instruction set and 27-bit 
mantissa floating-point format. BASIC's internal format is 27-bit, 
sign-magnitude mantissa floating-point; thus, all user-generated 
values must be in that format and all coding must be compatible with 
it. The user codes the function in the PDP-8 series machine language 
instructions, assembles it with the PALC Assembler, and loads the 
resulting binary file as an overlay to one of the existing functions 
(ATAN, LOG, etc.) Thus, while BASIC is running, this special function 
can be requested and used in a fashion analogous to the built-in BASIC 
functions. The user-coded function, if present, is specified in the 
BASIC program as: 

UUF(n) 

where n can be any BASIC expression. 


6.9.1 Coding Formats 

Due to memory restrictions, the user-coded function must replace one 
or more of the existing Cassette BASIC functions. Table 6-2 lists the 
functions which may be overlaid and the areas of memory they occupy. 
Also listed is the transfer table address through which BASIC calls 
the given extended function. 
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Table 6-2 Function Addresses 


Function 

Locations Occupied 

Transfer Tadale Address 

FNA 

5453-5546 

1131 

ATN 

6200-6271 

1134 

SQR 

5412-5452 

1137 

RND 

5350-5406 

1143 

TAB 

5547-5572 

1147 

The functions 
be deleted as 

SIN, COS, and TAN are 
follows : 

intcirdependent , but all three may 


SIN 

5600-5674 

1132 

COS 


1133 

TAN 


1144 


Almost a 

full 

page 

is freed by 

deleting 

the following: 

FNA 



5412-5572 


1131 

SQR 





1137 

TAB 





1147 

For each 

function 

replaced 

by the 

UUF, the user must set the 

corresponding 

transfer table 

location 

to point to an error routine so 


that accidental calls to that function will generate an error 
condition rather than a spurious call to the UUF. The user does this 
by inserting a statement such as the following in his UUF: 

+ 1143 /TABLE ADDRESS FOR R'JO 

5441 /POIMTER TO SYMTAX ERROR ROJIIiME 

To include a user-coded function, all conventions required for the 
PALC Assembler must be observed. The coding language is PDP-8 machine 
Icuiguage code, but Ccui include instructions in the modified 
floating-point pcickage, which is described later in this chapter in 
Section 6.10. 

When floating-point statements are to be included in the program, it 
is necessary only to indicate the start of floating-point notation by 
including the following operator: 

FENTER 

immediately before the first floating-point statement. Similarly 
floating-point coding is terminated by the operator: 

FEXIT 

immediately after the last floating-point statement. Thesre can be as 
many sections of floating-point code as necessary in the* program, but 
each must be delimited in this manner. 
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6.9.2 Floating-Point Format 


The floating-point format used by Cassette BASIC allocates three 
storage words in sign magnitude convention as follows (in sign 
magnitude convention the sign bit rather than the mantissa, expresses 
the sign of the entire number) : 


WORD 1 WORD 2 WORD 3 

HI [irfi[i'ii fTn niTiTiTi rri i n 1 1 1 1 1 1 1 

' V / 

EXPONENT MAIvrTISSA 

— SIGN BIT 


Five memory locations are used to represent the floating-point 
accumulator, as follows: 


Table 6-3 Floating-Point Accumulator 


Location Name 

Value 

Contents 

ACS 

0024 

Sign 

ACE 

0025 

Exponent (200 octal biased; 
i.e. the constant 200 is added 
to the exponent to make the 
range 0-377) 

ACl 

0020 

High order word 

AC2 

0017 

Mid order word 

AC 3 

0016 

Low order word 


All of BASIC's mathematical operations are in floating-point format; 
therefore, if any temporary storage locations are required by the UUF 
subroutine, they must specify three words. For example: 


UTEMP>0J0;0 


6.9.3 Incorporating Subroutines with UUF 

When adding a user function, it becomes necessary to reference some of 
Cassette BASIC's subroutines at specific times in the coding. Most of 
these calls are needed in order to preserve a compatible format 
throughout the system. The BASIC subroutines which may be referenced 
are described below. (The complete BASIC symbol table is included as 
Tcible 6-7 at the end of this chapter.) 
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BEGFIX 


If a value is to be returned to the accumulator as a result of the 
user function, that value must be in normalized floatin<j-point format. 
If floating-point arithmetic is used throughout the user function, 
then the value in the FAC (floating-point accumulator) is in 
normalized floating-point format and need not be converted. If 
fixed-point arithmetic is used anywhere in the function, then the 
subroutine BEGFIX must be referenced before the value (floating-point) 
is saved in order that the storage locations are properly initialized 
to accept a floating-point value. Using this procedure, the five FAC 
locations are prepared accordingly. However, because the value to be 
stored only requires 12 bits, a subsequent DCA AC3 statement is 
sufficient. BEGFIX is located at 3760 and is called via a JMS 
instruction. 


ANORM 

If a fixed-point value is added to the FAC, ANORM normalizes the FAC 
in order that it be in a format suitable for Cassette BASIC. The 
routine supplies the acceptable values for the locations ACE, ACS, ACl 
and AC2. ANORM is assigned the location 4600. 


FIX 

To convert a value in the FAC to an integer, as when printing a 
character, the subroutine FIX is called; it is located at 4744. 


6.9.4 Writing the Program 

A user-coded function must respt one of Cassette BASIC's tables to 
recognize the function, otherwise, UUF is considered to be an 
undefined function. The pointer is at location 1150; a statement such 
as the following is required; 

*1 1 50 
UUF 

Procedures for loading a user-coded function are contained in Section 
6.11.5. Examples of user-coded functions follow. 


6.9.5 Examples of User-Coded Functions 

Example 1 — This program calculates squares and square roots for a 
series of values. The BASIC program is as follows; 

100 FOR A=33.1 TO 33.9 STEP .1 
110 PRINT A^UUF(A)^SQR(A) 

120 NEXT A 
130 END 
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The user-coded function is : 

PALC-Vl 12/27/72 PA(iF: 1 
/ 

/'JSER-CODED FfJMCTION TO CALCULATE 
/SQUARES OF NUMBERS 

/ 

/THE FUNCTION LOADS INTO FIELD 0 



4435 

/INTO THE AREA OCCUPIED BY THE ’ATN» 

/FUNCTION 

FENTER=4435 


2000 

FST=2000 


0200 

FWD=200 


6000 

FMP=6000 


0000 

FEXIT=0000 


6441 

SXERR=6441 


1 1 34 

♦ 1134 

01 134 

6441 

SXERR /SO REFERENCES TO ATN WILL 


1 1 50 

/YIELD AN ERROR 

♦ 1150 

01 150 

6200 

UUF /DEFINE UUF IN FUNCTION TABLE 


6200 

♦ 6200 

06200 

0000 

UUF, 0 

06201 

4435 

FENTER /INTO FLT . PT . PKG . -A IS IN FAC 

06202 

2204 

FST+FWD+X-. /SAVE A 

06203 

6203 

FMP+FWD+X-. /A^A 

06204 

0000 

FEXIT 

06205 

5600 

JMP I UUF /ALL DONE 

06206 

0000 

X , 0 > 0 J 0 

06207 

0000 


06210 

0000 



0001 

FIELD 1 


3000 

♦3000 /TO START BASIC WHEN LOADED 


$ 


/ PALC-01 12/27/72 PALE 1-1 

FENTER A435 
FEXIT 0000 
FMP 6000 
FST 2000 
FWD 0200 
SXERR 6441 
7UF 6200 
X 6206 

The output after execution is: 

HUN 


3 3.1 

1095.61 

5.75326 

33.2 

1 102.24 

5.761944 

33.3 

1 108.89 

5.770615 

33 .4 

1115.56 

5.779273 

33.5 

1 1 22.25 

5 .787918 

33.6 

1128.96 

5.796551 

33.7 

1135.69 

5.80517 

33.8 

1 142 .44 

5.813777 

33.9 

1149.21 

5.82237 1 

READY . 
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Example 2— The following program tests a student's ability to convert 
the octal value in the console switches to its decimal equivalent. 
Line 120 will set P equal to the decimal value of the setting. Line 
130 determines if the correct answer was typed: 

100 PRIMT "'WHAT DECIMAL VALME DO THE SWITCHES EOHAL?” 

110 IMPHT M 
120 LET P = HfJF(0) 

130 IF P=M THEN 200 
1A0 PRINT "TRY ALAIN" 

150 <30 TO 100 

200 PRINT "CORRECT" 

300 END 

The user-coded function is: 

PALC-Vl 13/27/73 PAbE 1 


/ 

/'.ISER-CODED E'INCTION TO READ THE COMSULE 

/Sa/itches and convert to floating, point 
/ 

/THE F'JNCTION LOADS INTO FIELD EERO 
/INTO THE AREA PREOIO'JSLY OCC'JPIED BY 
/THE 'RND' F'JNCT lON-THE RANDOM N' lMBER 
/UENERATOR 
/ 

0000 FIELD 0 
4A35 FENTER=AA35 
0000 FEXIT=0000 
4000 FAD=4000 

2000 FST=8000 

0200 FWD=300 

3760 BE(iFIX = 3760 
4600 ANORM=4600 
0016 AC3=16 

6441 SXERR=6441 

1143 *1143 

01143 6441 SXERR /SO REFERENCES TO RND 

/WILL YIELD AN ERROR 

1150 *1150 

01150 5350 OOF /DEFINE OOF IN FUNCTION TABLE 

5350 *5350 

05350 0000 O'JF, 0 

05351 A756 JMS I URECiFIX /PREPARE FOR 

/INTEGER VALUE 

05352 7604 LAS /GET CONTENTS 

/OF SW. REG. 

05353 3016 DCA AC3 /SAVE IN LOW 

/ORDER FAC 

05354 A757 JMS I OANORM /N0HMALI?:E 

05355 5750 JMP I OOF /RETURN 

05356 3760 OBEGF IX> BEGF I X 

05357 4600 OANORM, ANOHM 
0001 FIELD 1 

3000 *3000 /TO START OP BASIC WHEN LOADED 

$ 

PALC-Vl 13/27/72 PAGE 1-1 

AC3 0016 
ANORM 4600 
BEGFIX 3760 
FAD 4000 
FENTER 4435 
FEXIT 0000 
FST 2000 
FWD 0300 
SXERR 6441 
JANORM 5357 
JBEGFI 5356 
OOF 5350 
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An example of a run in which 200 (octal) was set :Ln the console 
switches follows; 

RfJN 

WHAT DECIMAL VALUE DO THE SWITCHES EQUAL? 

7120 

TRY AGAIN 

WHAT DECIMAL VALUE DO THE SWITCHES EQUAL? 

7128 

CORRECT 

READY. 


6.10 FLOATING-POINT PACKAGE 

Information concerning the PDP-8 modified Floating-Point Package which 
the programmer will find useful in coding a function follows. 


6.10.1 Instruction Set 

The legal instructions in the modified Floating-Point Package used by 
Cassette BASIC are explained in Tcible 6-4; 


Table 6-4 Floating-Point Instructions 


Instruction 

Value 

Meaning 

FST 

2000 

Store the contents of the floating accum- 
ulator (FAC) . The contents of the 

FAC are not changed. 

FLD 

3000 

Load FAC withi contents of relative 

address. 

FAD 

4000 

Add contents of relative address to FAC. 

FSB 

5000 

Subtract contents of relative address 

from FAC. 

FMP 

6000 

Multiply the contents of the FAC by the 
contents of the relative address. 

FDV 

7000 

Divide FAC by contents of relative address. 

FJMP 

1000 

Floating-point jump to relative address. 

FENTER 

4435 

Start floating-point code. 

FEXIT 

0000 

Exit floating-point code. Return to PDP-8 
code. 

FWD 

0200 

Access a relative location in the forward 
direction. 

BKWD 

0600 

Access a relative location in the backward 
direction. 

FSNE 

0040 

Skip if FAC <> 0 

FSEQ 

0050 

Skip if FAC = 0 

FSGE 

0100 

Skip if FAC => 0 

FSLT 

0110 

Skip if FAC <0 

FSGT 

0140 

Skip if FAC >0 

FSLE 

0150 

Skip if FAC <= 0 
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The following instructions require indirect (and relative) addressing 
and therefore only address field 1. Their operation is the same as 
the corresponding direct instruction. 


Table 6-5 Relative Addresses 


Instruction 

Value 

Operation 


FSTI 

2400 

Store 


FLDI 

3400 

Load 


FADI 

4400 

Add 


FSB I 

5400 

Subtract 


FMPI 

6400 

Multiply 


FDVI 

7400 

Divide 


FJMPI 

1400 

Jump 



6.10.2 Addressing 

The Floating-Point Package uses relative addressing. Thus, all 
statements that address a location must include one of the operators 
FWD or BKWD plus a reference to thc‘ current location. Such a 
reference is generally in the form: 

op code instruction + FWD (BKWD) + LTEMP-. 

The operator FWD is used when the address of the location to be 
referenced is numerically greater than the current address; BKWD is 
used when the address of the location to be referenced is numerically 
less than the current address. LTEMP-. in conjunction with the FWD 
or BKWD operator defines the relative address of the location to be 
operated on (LTEMP) with respect to the current location. This 
relative displacement is then used by the Floating-Point Interpreter 
to access the contents of the three words at LTEMP. This can best be 
seen in an example: 

4010 FAD+FWD+LTEMP-. 


4063 LTEMP>0;0J0 

The contents of that location which is (4063-4010) locations forward 
from the current address, (i.e. the contents of LTEMP), are added to 
the FAC. Similarly: 

146 ALOC>0J0;0 


152 FMP+BKWD+.-ALOC 

At line 152 the contents of FAC are multiplied by the contents of the 
location that is (152-146) locations backward from the current 
address. 
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6.11 EDITING AND CONTROL COMMANDS 

Errors made while typing at the console keyboard are easily corrected. 
BASIC provides special commands to facilitate the editing procedure. 


6.11.1 Erasing Characters and Lines 

(SHIFT/0,, RUBOUTS, NO RUB OUTS , PlLTMODE) 

There are two methods available for erasing a character or series of 
characters one at a time. Typing a SHIFT/0 causes the deletion of the 
last character typed and echoes as a back arrow {•*-) on the LT33 (or 
35) Teletype, or as an underscore (— ) on most other console 
terminals. One character is deleted each time the key is typed. 

The RUBOUT key (or DELETE key on some terminals) may also be used for 
deletion of characters one at a time providing the command; 


RUB OUTS 

has been typed on the keyboard before the editing is done. This 
command enables the RUBOUT key to be used and must be typed each time 
a new program is in memory. If the user has neglected to type this 
command, he may not use the RUBOUT key. A later command of; 


NO RU)30UTS 

disables the key for use. 
For example; 


10 LEB-T A=10*B 

The user types a B instead of T and immediately notices the mistake. 
He may type SHIFT/0 (or RUBOUT key, if enabled) once to delete the B, 
(and as many times more as characters, including spaces, are to be 
deleted). After the correction is made, he may continue typing the 
line. The typed line enters the computer only when the RETURN key is 
pressed. Before that time any number of corrections can be made to 
the line. 


20 DEN FNA(X>Y)=Xt2 + 3*Y 

When the RETURN key is typed, the line is input as; 

20 DEF FNACX^Y) =Xt2+3*Y 

Notice that spaces, as well as printing characters, may be erased. 

The user may erase an entire line (provided the RETUR]^ key has not 
been typed) by typing the ALTMODE key (ESCAPE key on some keyboards) . 
BASIC echos back; 
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DELETED 


at the end of the line to indicate that the line has been removed. 
The user continues as though it were a new line. If the RETUPN key 
has already been typed, the user may still correct the line by simply 
typing the line number and retyping the line correctly. He may delete 
the line by typing the RETURN key immediately after the line number, 
thus removing both the line number and line from his program. 

If the line number of a line not needing correction is accidentlally 
typed, the SHIFT /O or RUBOUT key may be used to delete the number (s) ; 
the user may than type in the correct numbers. Assume tie line: 


10 IF A>5 GOTO 230 

is correct. The programmer intends to insert a line 15, but instead 
types : 


10 LET 

He notices the mistake and makes the correction as follows: 


10 LET^*-- --5 LET X=Z-3 

Line 10 remains unchanged, and line 15 is entered. 

Following an attempt to run a program, error messages may be output on 
the console terminal indicating illegal characters or formats, or 
other user errors in the program. Most errors can be corrected by 
typing the line number (s) and correction (s) and then rerunning the 
program. As many changes or corrections as desired may be made before 
runs . 


6,11.2 Listing a Program (LIST, LIST and LPT) 

An indirect program or data can be listed on the active output device 
by typing the command: 


LIST 

followed by the RETURN key. The entire program (or data) will be 
listed. 

A part of a program may be listed by typing LIST followed by a line 
number. This causes that line amd all following lines in the program 
to be listed. For example: 


LIST 100 

will list line 100 and all remaining lines in the program. 
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The LIST command may be used in conjunction with the LPT command as 
follows : 


LPT 

LIST 

This will list the current program on the line printer. Control is 
reset to the console terminal after the listing is completed. 


6.11.3 Running a Program (RUN, RUN and LPT) 

After a BASIC program has been typed and is in memory, it is ready to 
be run. This is accomplished by simply typing the command: 


RUN 

followed by the RETURN key. The program will begin execution. If 
errors are encountered, appropriate error messages will be typed on 
the keyboard; otherwise, the program will run to completion, printing 
whatever output was requested. When the END statement is reached, 
BASIC stops execution and prints : 


READY. 

The line printer, if available, can be used in conjunction with the 
RUN command, as follows; 

LPT 

RUN 


After this command is issued, all output during program execution is 
diverted from the console terminal to the line printer, eliminating 
the need of inserting the LPT statement within the program. The 
output device is reset to the console t€irminal after execution. 


6.11.4 Stopping a Run (CTRL/C, CTRL/0, CTRL/SHIFT/P, BR;EAK) 

To stop a program during execution or to return to the Keyboard 
Monitor at any time, type a CTRL/C (by pressing the CTRiCi key and the C 
key simultaneously) . This causes the current operation to be cdDorted 
immediately cind the Cassette Keyboard Monitor to be re-bootstrapped 
from the System Cassette. 

The command CTRL/0 (produced by typing the CTRL and 0 keys 
simultaneously) is used to stop teleprinter output temporarily. The 
program will continue to execute but output will not be printed unless 
an error occurs or unless BASIC is waiting for a command or for data 
from an input statement. In the latter case, the console terminal is 
the expected input device. This feature is particularly useful for 
programs that print lengthy introductions and then request a 
user-specified parameter. Typing CTRL/0 after the program is started 
will cause BASIC to bypass printing the introduction and wait until 
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the parameter is specified, thereby saving the time required to print 
the message. A second CTRL/0 will resume output. 

NOTE 

For most programs that do not wait for 
input from the terminal, processing of 
the program after an initial CTRL/0 will 
be completed before a second CTRL/0 can 
be typed. Thus, it is veiry possible for 
no output to be printed rather than the 
anticipated partial output. 


Certain terminals (such as Teletype models LT33 and 35) are equipped 
with a BREAK key which may be used in Cassette BASIC to interrupt 
program execution. Pressing the BREAK key causes a halt in execution 
and a return to the BASIC Editor for more commands. For those systems 
containing terminals not equipped with the BREAK feature, the same 
result can be produced by pressing the CTRL, SHIFT, and P keys 
simultaneously. 


6.11.5 Loading a User-Coded Function 

A user-coded function is created using the CAPS-8 EDITOR; it is 
assembled using PALC. The resulting binary file is loaded with BASIC 
using the Monitor Run or Load commands as follows: 


or 


.R BASIC, drive #: filename 
.L BASIC, drive #:filename 


Assume a user-coded function called UUF.BIN is stored on cassette 
drive 3. Assume also that the file UUF.BIN has been coded so as to 
include the correct starting address for BASIC. The user runs BASIC 
loading the function as follows: 


.R BASIC>UUF 

The starting address for BASIC is included in the program and coded as 
follows : 

FIELD i 
*3U00 
£ 

The new function may now be used in any files the user wishes to edit 
and run. 


6.11.6 Erasing a Program in Memory (SCRATCH) 
The command: 

SCRATCH 
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or 


SCR 

is provided to allow the programmer to clear his storage area, 
deleting any commands or a program which may have been previously 
entered, and leaving a clean area in which to work. If the storage 
area is not cleared before entering a new program, lines from previous 
programs may be executed along with the new progreum, causing errors or 
misinformation. The SCRATCH command eliminates all old statements and 
numbers and should be used before any new programs are read into 
memory or created at the keyboard. 

Note that the SCR command does not clear the program name. If the 
user wishes to create a new program with a new name, he should use the 
NEW command which also performs a SCRATCH. 


6.11.7 Renaming a Program (NAME) 

The user may change the neime of the program in memory by issuing the 
command : 


NAME 


BASIC responds by asking: 


NEW PROGRAtM NAME- 

The user specifies a new filename (and extension, if desired) . This 
changes the name of the program without affecting its image in memory. 
All subsequent references to the program must use this new name. 


6.11.8 Saving a Program (SAVE) 

Once the user hcis created or edited a program, he may v^ant to save the 
new version on a cassette for later use. He does this by typing: 


SAVE 

BASIC asks : 


UNIT 

to which the user responds with the number of the cassette drive on 
which he wishes the program to be stored. The program is saved under 
its current name — that is, the neime used in BASIC's initial dialogue, 
or its new name if the NAME command has been used to change it. (If 
the filename is the same as one already present on the cassette, the 
old file is replaced by *EMPTY in the directory and the new file is 
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written onto the cassette.) After the program has been saved, it is 
still in memory eind may be RUN or edited further. 

Attempting to save a program on a full cassette causes BASIC to return 
to the editing phase; the user must save the program on another 
cassette. 

If the user does not specify a name for his program in the initial 
dialogue (by responding with an ALT MODE to the NEW PROGRAM NAME 
request) , the program will be saved under the assigned name 
NONAME. BAS. 

If the user SCRATCHes a program, creates another program without 
assigning a name to it by use of the NEW or NAME commands, and then 
attempts to save it, it will be saved under the name of the last 
program which was in memory, possibly deleting that program if saved 
on the same drive. 


6.12 CASSETTE BASIC ERROR MESSAGES 

BASIC checks all commands before executing them. If for some reason 
it Ccinnot execute a command, BASIC indicates this by typing one of the 
following error messages and the number of the line in which the error 
occured. The form is: 


ERROR MESSAGE AT LINE XXXX 

Table 6-6 lists the errors BASIC checks for and reports before 
execution. 


Table 6-6 Cassette BASIC Error Messages 


Message 


Meaning 


ARGUMENT ERROR 

CHAIN ERROR 


DATA ERROR 


A function has been given an illegal 
argument; for example: SQR(-l) 

A cassette error occurred while doing 
program chaining; the user should not 
attempt to run the program in memory 
again. 

There were no more items in the data list. 


EOF ERROR 


EXPRESSION ERROR 


FILE NAME ERROR 


An attempt was made to recid past the 
end-of-file during run-time input. 
Program execution terminates and control 
returns to the Keyboard Monitor. 

One of BASIC's internal lists overflowed 
while attempting to evaluate an 
expression, 

A mistake or illegal character was found 
in the user's specification of a cassette 
drive # or file name in eithej: a CHAIN or 
an OPEN statement. 
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Table 6-6 Cassette BASIC Error Messages (Cont'd) 


Message 


Meaning 


FILE OPEN ERROR 


FOR ERROR 
FUNCTION ERROR 


The user attempted to open a run-time 

output file when one was already open, or 
a hardware error occurred. 

FOR loops were nested too deeply. 

The user attempted to call a function 

which had not been defined. 


GOSUB ERROR 
I O ERROR 

IN ERROR 

LINE TOO LONG 

LINE # ERROR 

LOOKUP ERROR 

NEXT ERROR 

NO FILES ERROR 

OUT ERROR 


RETURN ERROR 

SUBSCRIPT ERROR 


Subroutines were nested too deeply. 

The user attempted to do run-time input 
and output to the same cassette at the 
same time. 

A cassette error occurred while attempting 
to carry out an OLD command or while doing 
run-time input. 

A line of more than 80 characters was 
entered; BASIC ignores the whole line and 
waits for the user to enter a new line. 

A GOTO, GOSUB, or IF referenced a 

nonexistent line. 

BASIC could not find a run-time input file 
on the drive specified. 

FOR and NEXT statements were not properly 
paired. 

The user attempted to do run-time file I/O 
without first specifying so during BASIC's 
initial dialogue. 

An error (probably end-of-tape) occurred 
while doing cassette output either during 
a SAVE or during run-time output. If the 
error occurred during a SAVE , the user 
should retry the SAVE to a different 
cassette. If the error occurred during 
run-time output, he should re-run his 
program using a different cassette for 
output. 

A RETURN statement was issued when not 
under control of a GOSUB, 

A subscript has been used which is outside 
the bounds defined in the DIM statement. 
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Table 6-6 Cassette BASIC Error Messages (Cont'd) 


Message 


Meaning 


SYNTAX ERROR A command did not correspond to the 

language syntax. Common examples of 
syntax errors are misspelled commands, 
unmatched parentheses, and other 
typographical errors. Reference to an 
undefined UUF will also produce this 
diagnostic. 

TOO BIG, LINE IGNORED The combination of program size and number 

of variables exceeds the capacity of the 
computer. Reducing one or the other may 
help. Otherwise, the user must break his 
program into parts and chain them 
together, A large number of DATA 
statements might be put into a run-time 
input file. 


The following programming errors are not reported by Cassette 
BASIC, but instead are used in the computation as specified. They 
are included here for the programmer's reference. 

1. Attempting to use a number in a computation which is too 
large for BASIC to handle will produce a result which is 
meaningless . 

2. Attempting to use a number in a computation which is too 
small for BASIC to handle will result in the value zero 
being used instead, 

3. Attempting to divide by zero will produce a result which 
is meaningless. 


6.13 CASSETTE BASIC SYMBOL TABLE 

Table 6-7 lists the Cassette BASIC symbols and their values. 
This information is useful when writing user-coded functions. 
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Table 6-7 Cassette BASIC Symbol Table 


/PDP-* 8 /fc CASStTTE 

: BASIC 


p A L a - V e 

1 15/27/75 

1 PAGE 

51 

AHCDPF 

1763 

CLUSt 

6400 

OVLOOP 

5245 

FEXPF 

6067 

ahs 

ba^^S 

CLObEO 

1170 

1 ) n. P I T 

6731 

EEXPI 

6061 

Act 

LI ^^25 

CMSwCH 

0176 

echo 

7053 

FEXPU 

6064 

ACN 

aa 1 7 

C N A M b T 

0455 

EDIT 

2415 

FHER 

511 7 

ACS 


CNLLk 

0141 

EM.) 

2400 

filalt 

0367 

AC1 

0 M 

Lnlpp 

0501 

ENOLIN 

5702 

F ILNAM 

0600 

ACP 

0017 

cntfno 

7 060 

EM)NM 

733? 

FILNR 

1356 

AC^ 

0 016 

L 0 r L 0 

7407 

ENONUM 

3321 

EILl 

0606 

A n p t s 

0 0 7 1 

CMl LC)2 

0134 

endpol 

5743 

F I NO IT 

0560 

ALCMP 

aab 6 

CM 0 

1301 

E N T £ P 

6404 

F INOLU 

0566 

alloc 

1^60 

cnutLO 

0004 

EOF AD 

4526 

F lOER 

7135 

AL L^ 

3iao 

COLUMN 

0130 

EGFkTN 

6650 

FIX 

4744 

AL TmOD 

^P 6 l 

C 0 Ei C K 

PP77 

EPTR 

0060 

F I X E X I 

4773 

ali 

abba 

COMMAS 

617b 

EPPOR 

4136 

FIX ITU 

5200 

A M A T C H 

6b06 

L 0 M N U N 

3377 

E V A L 

1000 

EIXLIN 

2135 

AN 0 PM 

a 6 0 0 

C 0 M 0 N 

1 IP3 

Ev algo 

1004 

FIXLUP 

4/50 

APGLRR 

7Pa7 

CONST 

1367 

EXECUT 

0213 

FIXUP 

5143 

A R P L 0 C 

0 0 x 

COkEIN 

04P3 

EXIT 

2407 

FJMP 

1000 

API 

aaz? 

COS 

5616 

Exp 

6000 

F JMPI 

1400 

A S K A G N 

Uib 

C fOv T 

7143 

tXPGOO 

5242 

F JUMP' 

1 130 

ATLINt 

babl 

4 R I N 1 X 

30 7 3 

t X P L 0 N 

5/64 

FLO 

5000 

ATN 

6 i/! 0 

CRLF 

6b31 

£ X |3 0 K 

5265 

FLOI 

3400 

A T N' H I G 

6P6b 

C R L F L) 

bPb? 

e.xTLOC 

0224 

FLOGCl 

6172 

ATNilOW 

6Pc!0 

C P L F P R 

3 7 36 

FAD 

4000 

FL0GC2 

6153 

A T ^ K 0 T 

6 P A 7 

CTklC 

000b 

F A 0 EXT 

1314 

FL0GC3 

6156 

H A 0 r H N 

7 0 b 4 

CTKLC J 

7604 

EADI 

4 400 

FL0GC4 

6161 

H A P P 0 

0 7^4 

CTkLZ I 

6655 

ealt 

0644 

FMP 

60 00 

h C P w D S 

ab0P 

C T K 7 C K 

'M 1 3 

E A T N A X 

627 3 

FMPT 

6400 

H L G F IX 

37 60 

CTkZmP 

0055 

E A FNC: 

6337 

FMTENF 

5121 

PK i* 0 

0600 

tv ( LUO 

5055 

F A T N C H 

634? 

FMTl 

5123 

PR f A K 

6bPP 

L' A ] A E K 

1 675 

F A T N C J 

6345 

FMT2 

5051 

P S K I P 

P73b 

U F C p: X P 

004 3 

fatnci 

6304 

FMT3 

5126 


7 00P 

UEC.FPA 

5343 

fa FNCa 

6307 

FN 

5453 

R Li F F N 0 

6 P 0 0 

0 f: t p E p 

0 53 0 

FATNC3 

631? 

FNERR 

5172 

hIjFST 

6 0 0 0 

UF.P 

1575 

F ATNC4 

6315 

FNtXIT 

1200 

CAM 

76P 1 

C F: L E T E 

6501 

E ATNC5 

6320 

FOR 

0415 

capret 

5664 

Li e V c 0 H 

7 354 

F ATNCb 

6323 

FORCT 

0065 

CASIN 

h 6 1 4 

Ui 1 b I i'J 

3551 

F ATNC7 

6326 

FORDON 

0663 

C A S fj U T 

6 / 0 5 

U 1 b I N 1 

35P5 

fatnch 

6331 

FORERR 

0503 

C C N T P 

0 R 4 6 

C T b I T 

317b 

F A T N C 9 

6334 

forlim 

0721 

CGt T 

66 bl 

bl bl, UP 

6557 

F A T N S X 

62/2 

FORLIS 

5744 

C M A i M 

7 0) 3 1 

UIM 

64 7 5 

F ATNT 

6276 

FORSTE 

0 7 2 4 

C h A p- N t 

0 0 b 1 

R 1 M P L A 

0 0 34 

F A T N T T 

6 30 1 

FOR VAR 

0 4 54 

C HA WOK 

•/j 6 a 1. 

c I vLP 

4 /05 

FuIGIT 

3335 

FOUND 

0576 

r H t c K w 

5344 

Cl V X Tt 

3341 

F D V 

7 000 

FPAOO 

4456 

chkf n 

6 4 00 

COI T r/U 

1547 

ED VI 

7400 

FP AODR 

4 30 4 

ChNP PR 

3 36P 

uOuE N 

0/45 

F enter 

4435 

EPOI V 

466 / 

C f M G 

30c 3 

U 0 IN s w 

0 5 0 

FtPP 

0746 

F pooit 

4237 

C H N M S 

3 56 3 

b Cl 6 c R T 

3045 

F t )( I T 

0 0 y 0 

FPFLAG 

0154 

ChPGET 

0 4 1 / 

UO f 7EP 

6576 

F E )( P C 1 

6072 

F PGOTO 

4273 

C K A K 

0 34 4 

u P r L A G 

3345 

F E X P C 5 

6075 

FP JMP 

4317 

C K C T P / 

4 1/4 

up ir^TX 

3165 

Et)(FC3 

6 100 

FPJUMP 

4274 

C L E A w V 

P4b<4 

ij P u n T h 

"■•656 

F E X R C 4 

6 103 

FPLAC 

4351 

CLE V 

0 b 0 b 

OR 1 1 

6 6 5 7 

F t X P C 5 

6106 

FPLOOP 

4202 

C L 0 S 

0 0 36 

uP 1 ICK 

7 33 / 

F E X R C 6 

6111 

FPMUL 

4 5 30 
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Table (5-7 Cassette BASIC Symbol Table CCont'dI 


/PDP-8/E CASSETTE 

: BASIC 


PALB-V8 

i 12/27/72 

! PAGE 

51-1 

FPNOAD 


GETOPR 

1012 

iNLOOP 

0573 

LET 

0304 

PROPER 

4305 

i»FTUNl 

0240 

INUUPF 

0434 

LETDO 

0205 

FPP67 

4227 

GETVAR 

0303 

INPLUP 

4034 

letter 

3445 

FPSKIP 

4314 

GE rwD 

0177 

INPPTR 

4076 

lfxlup 

2331 

FPSTO 

4322 

GLOnp 

2711 

InPSET 

0553 

lhalf 

3067 

FPSUB 

4453 

GNtXT 

0607 

INPTN 

0272 

LIBIT 

1600 

FPT 

4 200 

GObOTH 

0534 

INPUT 

4007 

LINBUF 

5551 

FpTtMP 

4576 

GOLIST 

5764 

INPUTN 

7316 

LINENO 

0054 

FPTR 

006 1 

gosub 

0507 

INSERT 

2027 

LINFIX 

2326 

FPZOIV 

4 7 36 

GOl F.MP 

0055 

INSRT5 

2025 

LIST 

3600 

FRINP 

1243 

got IT 

7207 

INT 

6434 

LISTAL 

3610 

FRINPI 

1261 

GOTITl 

7210 

INWDTM 

4136 

LISTLU 

3612 

FRNiOX 

5404 

Gtn 0 

0521 

lONAM 

0227 

LISTSO 

3611 

FROUT 

1 302 

GO ! OPK 

1202 

lOUNJ T 

1301 

LIST2 

3636 

FRSTNE 

2101 

GOVSS 

1071 

IPNOPE 

4024 

LIST3 

3655 

FSB 

5000 

GOTSTE 

0634 

ISDEF2 

3511 

LIST4 

3661 

FSB I 

5400 

GOUT 

7244 

ISUIG 

6532 

LISTS 

3676 

FSFQ 

005 0 

GP IR 

0062 

ISOIM 

1472 

litral 

3123 

F 5 OF- 

0 100 

GRB 

7223 

I SIT 

4564 

LJBS 

7255 

FSET 

1/114 0 

gpuela 

7221 

ISITOF 

0551 

LKER 

1312 

FSliMCl 

57 13 

gsbeno 

5777 

ISITFU 

1 1 05 

LKERR 

0330 

FSIMC3 

57 16 

GSbPTR 

0 163 

ISITLI 

4100 

LLSOUT 

7400 

FSiNCa 

5721 

GSSl 

1555 

ISITl 

4422 

LNOENO 

3626 

FSiNCb 

5/24 

GSS2 

1556 

islit 

4127 

LOAOEO 

4123 

F s I ^ r. 6 

5/27 

GTtJKLP 

1 72? 

iSSDMt 

1643 

LQCCTR 

0045 

FSI^JC/ 

5 7 32 

GTtMP 

7270 

ISUBIN 

1010 

LCCTEM 

0671 

FSINM4 

5735 

gTJMP 

0442 

ITSDEF 

3513 

LCCTMP 

1677 

FSI'VOK 

5657 

uTjMPI 

0420 

ITSDP 

3217 

LCG 

6114 

FSINZ 

5 7 05 

oTPTR 

0036 

ITSE 

3253 

LCGACE 

6165 

fsinzz 

57 10 

HAF 

0437 

ITSUP 

1220 

LCGFwO 

6164 

F S I N 1 

564 1 

HALF 

0451 

ITSF 

3270 

LOGOKW 

6167 

FSLt 

015 0 

b I GHwD 

4333 

I UN IT 

6660 

LOOK 

0306 

FSLT 

0110 

MLOOP 

2677 

JbPENT 

3707 

LOOKER 

7310 

fsnjE 

0040 

nLOPl 

27 31 

JISDIG 

3344 

LOOKUP 

7002 

fsqkx 

5407 

HLP 

4163 

JMATCH 

2770 

LOwLQC 

2166 

FST 

2000 

MMOLR 

6600 

JPUTCH 

0763 

LFTOUT 

7347 

FST I 

2400 

nP fP 

0063 

JUST0 

3142 

llikerr 

0326 

FT ant 1 

56 7 / 

IAiMLES 

2103 

JUST0F 

3152 

LLINIT 

0332 

F T A N T 2 

5/02 

JL AN0O 

6764 

JUST0P 

3155 

LLIR 

3404 

Fu^nAB 

1131 

1 A J 

1 257 

JUSTl 

3137 

LLIPF 

0430 

FUPRCI 

5762 

iCASEP 

5157 

JUST 2 

3141 

L4LUP 

3664 

F w 0 

0200 

irUUNT 

6G62 

K B U I N 

0421 

MAYZER 

4612 

FV XPFX 

602 3 

J. E K W 

6663 

KHDINP 

7626 

MEIREAK 

7603 

GALT 

7 24? 

iEXTLC 

0235 

KHUFEN 

6762 

be;noli 

0041 

GO IBP 

1557 

IF 

0372 

KdUF ST 

6737 

me:nopd 

2361 

GET 

00 01 

IFl 

0403 

K E P T R 

00 7 7 

MGOLIS 

0720 

GET ADD 

1 4 0 0 

IGMOkE 

2137 

KEYWU 

0231 

MGSBEN 

0527 

GhTbLK 

1 7 t: 0 

ImmEl) 

1 155 

KIGNOR 

1676 

b:;nus 

1316 

GF7CH 

/200 

1 M M E 0 A 

1155 

KB200 

00/2 

BLBEGI 

0171 

GF.TCHR 

i/i h / 2 

IN 

3430 

K M 4 0 0 4 

2170 

blend 

0172 

GtTCP 

0/12 

INCHn 

7 403 

K5000 

2167 

blinbu 

0040 

GET TT 

0275 

J.UUF.V 

0131 

Kb201 

7005 

M N s 0 N f: 

0736 

GETJ 

1765 

i N G F X 1 

0014 

L aSEKR 

6612 

MQNITR 

0100 

getlin 

8602 

i ^ J U E X 2 

00 1 5 

LBEGIN 

5622 

BOREUI 

6470 

GE TlRE 

25 ! 1 

XNLCTM 

407 7 

LERR 

3355 

MQREIN 

4000 
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Table 6-7 Cassette BASIC Symbol Table (Cont'd). 
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0013 

07600 

4345 

MOVE 
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17 76 

01000 
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5345 

MPP I NT 
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oil 
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O7640A 

0754 
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2236 
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MtL 

7 a 2 1 
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0055 
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IN T C M A N 
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07 7060 

3472 
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2745 
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1200 

017 
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3352 

077258 

3346 

MULX 1 

33/1 

NurCHR 

0726 

017 7 

0027 

07737 

3116 

MU5TPE 

as^'6 

N0ULMS 

51?4 

0 17/0 

3553 

07740 

0056 

NAM 

0 32? 

U A to 

4435 

02 

0064 

0774 1 

3743 

N AMCHK 

06S1 

uC aseR 

2574 

02 0 

1151 

07743 

4743 

NAME 

1037 

uc:o 

5205 

0200 

0153 

07745 

0160 

M A M fc p 

003? 

U c U U N T 

67 61 

02040a 

3350 

07/53 

3101 

NamlOC 

0 ? 1 6 

Lj E R P 

6 75 7 

02062 

5344 

07762 

2325 

N C T H L 

6 7 2S 

UIP 

7 35 7 

0212 

0175 

07763A 

0761 

N E W 

10a7 

U J U M p 

1 276 

0215 

0174 

077636 

30 76 

N t i*/ C H A 

?6?? 

01. 0 

1 057 

02 3 

1 566 

U7764A 

1274 

Nfc Wl;0 

IMS? 

ULCMK.) 

1062 

n<r3 3 

37 7 0 

07 764B 

3077 

newlin 

?606 

Cl L 0 K L 0 

2063 

0240 

0051 

07764C 

3351 

Nt i*!MES 

110 6 

ULOMES 

nil 

02 5 3 

5145 

07 766 

5151 

NEXT 

0 6 0 0 

uL unp 

00 7 0 

0255 

5146 

07 770 

0057 

NtXTER 

0 b / 3 

0LU3 

1 100 

0256A 

5153 

07 7 7 1 

5152 

NEX TG 

27S7 

UML 

0147 

0256B 

6575 

07 772 

5154 

N E X T V A 

0 6 3 7 

UMEDIM 

1061 

02 60 

0012 

077 73 

5346 

NE MES 

0S0 7 

ONtSS 

1073 

02 7 

3345 

07774 

1561 

NE OPEN 

6365 

UE LYl 

3312 

0305 

5147 

07776 

3347 

NMl 

1043 

UC?7 600 

5452 

032 

3115 

PACN 

4 742 

nobump 

4633 

00/736 

2324 

036 

277 1 

PAD 

0347 

NGCHNG 

3040 

UPuONE 

1203 

03 7 34 

1152 

PAODON 

0741 

N Cl c n M 

6)76 

OPE 

0030 

03737b 

0776 

PAK0UF 

0763 

N Cl C 0 M M 

0 32 7 

OPEN 

3575 

03755 

127 3 

PALI 

0146 

NOCh 

4056 

OPEN 1 

1200 

03 7 7 

00 73 

PANORM 

0144 

N n N b L N 

3104 

UPtRAN 

0075 

04 

0156 

PAKGER 

0047 

NfJNZER 

5014 

0 p N e: R R 

1354 

040 

2777 

PARI 

0145 

nhpape 

103? 

UPUTA8 

7016 

04 014 

1153 

PASSCR 

0474 

NOPCP 

???0 

UPS 

0026 

04? 

3103 

PBARHO 

2773 

NOPE 

13)4 

UPUTC 

7147 

04200 

3102 

PBEGFI 

1773 

NCIPLFT 

64?3 

UP 1 

0023 

04213 

1154 

PCCUNT 

0744 

NDPMEID 

5??0 

0P2 

0022 

05400 

5347 

PCHKFI 

0161 

norm I T 

5207 

OP 3 

0021 

06203 

0046 

POLOS 

0143 

NORUHO 

5574 

OT EMP 

1271 

07 

0074 

pcomma 

0273 

NOS SI 

1457 

UTtMPl 

7012 

07 00 

1272 

PCOwT 

0137 

N0SS2 

145? 

OTHER 

3000 

O/000A 

2565 

PDL 

0036 

NOT 

3426 

CJUNIT 

6760 

O70P0B 

3473 

POLIST 

5703 

NClTbAD 

?153 

OUPSET 

1026 

07077 

1275 

PEOIT 

0122 

NOTBIG 

4620 

our DEV 

0133 

0/520 

5150 

PENDN 

0271 

MOTOR 

3023 

QU r 02 

013? 

07545 

4777 

PENDNM 

0365 

motem 

6626 

UIJ TNUM 

5000 

0/570 

6456 

PERMSY 

511 1 

NOTFUL 

67 12 

uuroK 

1332 

07577 

4577 

PERROR 

0101 
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PAL6-V A 

1 12/27/72 
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51-3 

P t F ? W 

0 / a 7 

P p X X E 0 

1 162 

P 7 6 4 0 

0722 

SOLOOP 

5435 

K f-. V A L 

0 1 k. 3 

P P c N T 

2315 

QEkkOk 

1571 

S(3R 

5412 

Pf- XhCU 

/i 1 k'' 5 

PRESET 

0136 

Q M K 

0 7 7 1 

SSERR 

1563 

p e X p 

5776 

P P I fv B L 

2302 

R B S w C H 

0135 

SSFIx 

4/75 

P h 1 Ni [.■' I 

06 /P 

P k I M C 0 

2306 

k c H k 

6763 

SSQNE 

0336 

PM X 

011 0 

P P I rvi E X 

221,5 

READ 

1622 

SSTWO 

0337 

P P N E P P 

SSab 

P P 1 N M A 

2260 

kk ADIT 

6664 

ST 

3005 

PEPLOO 

45 75 

PR I GQU 

2227 

kE ADLO 

0046 

star 

1327 

P6ETAU 

Cl £' a 

PRiMSE 

2320 

READY 

6525 

S'^ARTH 

3000 

PGtTBL 

0117 

P P J N T 

2172 

RELATE 

1342 

STICKI 

6430 

PUfcTCH 

LU3r? 

PRINTC: 

2207 

REMPAC 

3043 

S'^OBUF 

0747 

Pr^ETLI 

0 1 B 6 

PRlMTG 

2206 

RtOEEk 

6700 

S’^QP 

2401 

PGE ILK 

30 BP 

k P I M r t', 

2224 

RE SETl 

70 72 

S''URCH 

0704 

PGtinP 

137 6 

P P 1 M T h' 

7322 

RESTOk 

377 1 

S-'OVAR 

03 3 3 

P G E T V A 

0 115 

PR IMTX 

3702 

RETNEk 

07 13 

SWP 

7521 

pgol TS 

016B 

P R I f' 1 2 

2174 

return 

0677 

S)(ER 

0551 

P GOT OP 

Mil 

PklNUJO 

3745 

RhALF 

307 1 

SKERk 

644 1 

P P L. P 

0 3 b 3 

P P i N V M 

3651 

RIGHT 

0433 

TAB 

5547 

P I r-MOK 

0 7 3 

PPL OOP 

13 7 1 1 

RIP 

6661 

TaBDES 

6375 

P I ^ T 

56/6 

PRM 

0243 

roleft 

6413 

TABOO 

6350 

p I E I T L 

017 3 

k P u G iM A 

1114 

RND 

5353 

tabflg 

2343 

P L r't G I 

0 1 / 0 

kPoijbk 

372? 

RNO J MP 

5350 

tabl 

3652 

Pit TOO 

OPLA 

PR 1 EMP 

0042 

RTBE ND 

1600 

TaBTHP 

2360 

ple tie 

3100 

PPTXkt 

3720 

RTBUF 

1400 

TAN 

5600 

PL If- IT 

c’Shb 

p s A V e 

2463 

PT lOME 

3103 

TBEGFI 

5572 

PL IGWU 

003 7 

P S b N 

5675 

RUHO 

5573 

TEMP 

0003 

PL INK I 

0 157 

k S K I P 1 

1616 

RL'N 

2457 

TEMPS 

3102 

P L. I S T 

B b 7 0 

PSUfU-lP 

0120 

RgNC 

2456 

TEN 

0000 

P L I T P A 

3 35 a 

P S P A C E 

1 560 

RUNIIN 

2510 

TMESKI 

1353 

PLUG 

57 7 5 

P f) T I C K 

0123 

PUNLUP 

2472 

TLSOUT 

7402 

PLU? 

1 31B 

kS 1 OP 

377b 

R U N N 0 T 

2504 

TMP 

0031 

P M H PEA 

0 3 b « 

PS rovM^ 

0114 

RUN2IN 

2550 

TOOLON 

5162 

P M P Y 

5155 

PSxEkk* 

0 102 

RU^J2LU 

2521 

TPRINT 

6376 

P E) B P 6 

5156 

P S Y H T A 

00S2 

RUN2N0 

2544 

TRALUP 

2131 

PGE,U,L I 

117 7 

P T AbOE 

5570 

SAVE 

1 000 

TRANSF 

2126 

P N 0 B L 

01B4 

ptabei. 

557 1 

SAVEl 

2461 

TRYAGI 

5131 

PNiOTNQ 

B5 7 3 

PTAbLE 

277b 

SCHOUR 

1656 

tryal 

0270 

PNLJMBU 

00 414 

P 1 1 N 

0150 

SCRATL 

2445 

tryalt 

0271 

PL ADU 

0155 

PTE XT 

0100 

SCRaT 1 

0332 

TRYQLO 

3075 

PC IP 

0035 

PTUBIG 

3021 

SEARCH 

1657 

tryste 

0626 

POP 

4 16 6 

PlJbEkF 

5545 

SET INC 

0200 

TTYO 

7024 

PCPERA 

31c?l 

PUSH 

2362 

5ETSGN 

4512 

ttyout 

7350 

POP3 

4434 

PiiTCOF 

7014 

SON 

0726 

tubig 

1 173 

PODT NU 

0121 

P 1 J T C H 

074 1 

s imply 

3465 

T WIDTH 

2355 

PPASSC 

0112 

PUTEk 

7000 

SIN 

5624 

twolf 

3557 

PPDL IS 

0lc7 

Pl'T J 

3550 

SJUMP 

0241 

TWQSS 

1074 

PPEPMS 

2572 

PWhFkE 

0647 

SMPIT 

0471 

TXTPAK 

3046 

ppp'L no 

4741 

P X F 0 k L 

055 7 

SKPSYM 

2762 

TVOUES 

1145 

PPFOPL 

1 7b4 

PXLlNb 

3744 

SLASH 

1332 

UOOPER 

1363 

PPINT 

6060 

PXXCKL 

3117 

SLOOP 

2675 

UGHl 

3561 

PPOP 

010 7 

PXXEOF 

2571 

SLSHTM 

1337 

UJMS 

0004 

PPPINT 

0116 

PXXEXI 

3120 

SNUMF L 

0066 

UMOPER 

1321 

PPPINU 

PJ125 

PXXL IT 

3122 

SPACER 

1163 

UNOERF 

4645 

FPUSH 

0106 

PXxThE 

2567 

SPLEFT 

0142 

UNIT 

0012 

HPUTCH 

0033 

PZtkDC 

6545 

SQEXIT 

5450 

UF'ARRO 

6457 
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5204 
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4365 

xXbOTU 

5300 

XX TEXT 

5540 

userfn 

1617 

XXGT 

5147 

X X then 

5305 

UTEM 

0411 

XX IF 

5312 
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5165 
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XXiNPT 
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X X T T Y 0 

5437 
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0400 
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5337 

X XUNAR 

5542 

ULUMS 

0401 
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5231 
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5122 
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0416 

XXLbRA 

5163 
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5253 
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0335 
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0554 

xxlEt 
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7147 
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34 7 4 
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3517 
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6600 
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5114 



WTEP 
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A XSAV 

5517 
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5434 

X V S A V K 

5513 



V y E N 0 N( 
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X y 6Ck 

5510 
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554 1 
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5153 



X X 0 
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5Saa 

A X S I N 
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> X F. X P 

5P15 
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5120 
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5543 

AXbUK 

5220 
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51 76 
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5250 




6-64 




CHAPTER 7 
USING CAPS- 8 CODT 


Using CODT, the programmer Ccin run his binary progreim on the computer, 
control its execution, euid make alterations to his program by typing 
at the Teletype keyboard. 

CODT occupies any four pages of core, in the same field, that the user 
desires. The user may change the location of these four pages of core 
by reassembling the source. If the user program resides in the first 
few pages of memory, then CODT should be loaded in the upper pages of 
memory, emd vice versa. The user progrcun cannot occupy (overlay) any 
location used by CODT, including the breakpoint locations (locations 
4, 5, and 6 on page zero). 


7 . 1 FEATURES 

CODT features include location exciraination and modification; octal 
core dumps to the Teletype using the word search mechanism; and 
instruction breakpoints to return control to CODT (breakpoints) . The 
user's program Ccin run with interrupts on. CODT may reside in any 
field, not necessarily the same as the user's field. 

The breakpoint is one of CODT's most useful features. When debugging 
a program, it is often desirable to allow the program to run normally 
up to a predetermined point, at which the programmer may examine and 
possibly modify the contents of the accumulator (AC) , the link (L) , 
or various instruction or storage locations within his program, 
depending on the results he finds. To accomplish this, CODT acts as a 
monitor to the user program. 

The user decides how far he wishes the program to run and CODT inserts 
an instruction in the user's program which, when encountered, causes 
control to transfer back to CODT. CODT immediately preserves in 
designated storage locations the contents of the LINK and AC at the 
breeik. It then prints out the location at which the break occurred, 
as well as the contents of the LINK and AC at that point. CODT will 
then allow excunination and modification of any location of the user's 
program (or those locations containing the AC cind L) . The user may 
also move the breakpoint and request that CODT continue running his 
program. This will cause CODT to restore the AC and L, execute the 
trapped instruction and continue in the user's program until the 
breedcpoint is again encountered or the program is terminated normally. 
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7.2 USING COOT 


When the programmer is ready to start debugging a new program at the 
computer, he should have at the console: 

1. A binary copy of the new program on a cassette. 

2. A complete octal/symbolic program listing. 

3. A binary copy of the CODT program (previously assembled so as 
not to interfere with the user's progreim) . 


RUN PROG, CODT 

The binary of CODT must be the last file to be run. Execution 
automatically begins in CODT. 


7.2.1 Commands 


SLASH (/) — OPEN PRECEDING LOCATION 

The location examination character (/) causes the location addressed 
by the octal number preceding the slash to be opened and its contents 
printed in octal. The open location Ccin then be modified by typing 
the desired octal number and closing the location. Any octal number 
from 1 to 4 digits in length is a legal input. Typing a fifth digit 
is an error cind will cause the entire modification to be ignored and a 
question mark to be printed by CODT. Typing / with no preceding 
argument causes the latest named location to be opened (again) . 
Typing 0/ is interpreted as / with no argument. For example: 

400/6046 
400/6046 2468? 

400/6046 12345? 

/6046 

The memory field referenced is that field specified by the location in 
CODT symbolically referenced by F. For example, if the contents of F 
were 20, then the command 

423/ 

would examine location 423 in memory field 2. 
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RETURN — CLOSE LOCATION 

If the user has typed a valid octal numlDer, after the content of a 
location is printed by CODT, typing the RETURN key causes the binary 
value of that number to replace the original contents of the opened 
location and the location to be closed,. If nothing has been typed by 
the user, the location is closed but the content of the location is 
not changed. For example: 

400/6046 
400/6046 2345 
/2345 6046 

Typing another command will 
example : 

400/6046 401/6031 2346 
400/6046 401/2346 


location 400 is unchanged 

location 400 is changed to contain 2345. 

replace 6046 in location 400. 

also close an opened register. For 


location 400 is closed and unchanged and 
401 is opened and changed to 2346. 


LINE FEED — CLOSE LOCATION, OPEN NEXT LOCATION 

The LINE FEED key has the same effect as the RETURN KEY, but, in 
addition, the next sequential location is opened and its contents 
printed. For example: 

400/6046 location 400 is closed unchanged and 401 

0401/6031 1234 is opened,. User types change, 401 is 

0402/5201 closed containing 1234 and 402 is 

opened . 


SEMICOLON — CLOSE LOCATION, AND UNOBTRUSIVELY OPEN NEXT LOCATION 

The SEMICOLON key has the same, effect as the LINEFEED key except that 
the location and contents of the next sequential location are not 
printed. Therefore, 

400/6046 3211; 4162; 5000 

has the same effect as 

400/6046 3211 
401/6031 4162 
402/5201 5000 

This makes it convenient for the user to chcinge several sequential 
locations. 


t (SHIFT/N) — CLOSE LOCATION, TAKE CONTENTS AS MEMORY REFERENCE AND 
OPEN SAME 

The up arrow (circumflex) will close an open location just as will the 
RETURN key. Further, it will interpret the contents of the location 
as a memory reference instruction, open the location referenced and 
print its contents. For excimple: 
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404/3270+ 3270 symbolically is "DCA, this page, 

0470/0212 0000 relative location 70,'* so CODT opens 

location 470. 


(SHIFT /O) CLOSE LOCATION, OPEN INDIRECTLY 

The Back arrow (or underscore) will clo.se the currently open location 
and then interpret its contents as the address of the location whose 
contents it is to print cind open for modification. For example: 

365/5760+ 

0360/0426-^- 

0426/5201 


nnnnG — TRANSFER CONTROL TO USER AT LOCATION nnnn 

Clear the AC then go to the location specified before the G (in the 
field specified by F) • All indicators and registers will be 
initialized and the breeikpoint, if any, will be inserted. Typing G 
alone will cause a jump to location 0 , 


nnnnB~SET BREAKPOINT AT USER LOCATION nnnn 

Instructs CODT to establish a breakpoint at the location specified 
before the B (in the field specified by F) . If B is typed alone, CODT 
removes any previously established breakpoint and restores the 
original contents of the break location, A breakpoint may be chcinged 
to another location, whenever CODT is in control, by simply typing 
nnnnB where nnnn is the new location. Only one breakpoint may be in 
effect at one time; therefore, requesting a new breakpoint removes any 
previously existing one. 

A restriction in this regard is that a breakpoint may not be set on 
any of the floating-point instructions which appear as arguments of a 
JMS. For example: 

TAD 

DCA Breedcpoint legal here. 

JMS 

FADD Breakpoint illegal here. 

A breakpoint may not be set on a CIF instruction, nor on an 
instruction which is meant to be executed between a CIF and its 
corresponding JMP or JMS instruction. 

A breakpoint may not be set on a memory reference instruction which 
references an auto-index register, 

A breakpoint may not be set on a two-word EAE instruction, nor may it 
be set on any of the following instructions : 
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SKON 

ION 

lOF 

The breeikpoint (B) commauid does not make the actual exchange of CODT 
instruction for user instruction, it only sets up the mechanism for 
doing so. The actual exchange does not occur until a "go to" or a 
"proceed from breeikpoint" command is executed. 

When, during execution, the user's program encounters the location 
containing the breakpoint, control passes immediately to CODT (via 
location 4, 5, and 6). The C (AC) and C(L) at the point of 

interruption are saved in special locations accessible to CODT. The 
user's data field is stored in location D and his instruction field is 
stored in location F as well as internally by CODT, The user 
instruction that the breakpoint was replacing is restored before the 
address of the trap and the content of the LINK eind AC: are printed. 
The restored instruction has not been executed at this time. It will 
not be executed until the "proceed from breakpoint" command is given. 
Any user location, including those containing the stored AC and Link, 
can now be modified in the usual manner. The breakpoint can also be 
moved or removed at this time. 

An example of breakpoint usage follows the section "CONTINUE AND 
ITERATE LOOP...". 


A — OPEN C(AC) 

When the breakpoint is encountered the C(AC) and C(L) are saved for 
later restoration. Typing A after having encountered a breakpoint 
opens for modification the location in which the AC was saved and 
prints its contents. This location may now be modified in the normal 
manner (see Slash) and the modification will be restored to the AC 
when the "proceed from breakpoint" command is given. 

Similarly, other key locations in CODT may be examined and modified as 
follows; 


L — OPEN CONTENTS OF LOCATION L (LINK) 


F — OPEN CONTENTS OF LOCATION F 


D-— OPEN CONTENTS OF LOCATION D (USER'S DATA FIELD) 
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NOTE 


Whenever any of the locations A, L, F, 
D, M are referenced, CODT automatically 
sets the value of F to be the field of 
CODT. 


C— PROCEED (CONTINUE) FROM A BREAKPOINT 

Typing C, after having encountered a breakpoint, causes CODT to insert 
the latest specified breakpoint (if any) ; restore the contents of the 
AC and Link; execute the instruction trapped by the previous 
breakpoint; and transfer control back to the user program at the 
appropriate location. The user program then runs until the breakpoint 
is again encountered. 

Regardless of the value of F, the C command resumes program execution 
at the precise spot where it had been previously stopped. The user's 
data field is first set to that specified by location D. 


NOTE 

If a trap set by CODT is not encountered 
while CODT is running the object 
(user's) program, the instruction which 
causes the break to occur will not be 
removed from the user's program. 


nnnnC — CONTINUE AND ITERATE LOOP nnnn TIMES BEFORE BREAK 

The progrcimmer may wish to estciblish the breakpoint at some location 
within a loop of his program. Since loops often run to many 
iterations, some means must be available to prevent a break from 
occurring each time the break location is encountered. This is the 
function of nnnnC (where nnnn is an octal number) , After having 
encountered the breakpoint for the first time, this command specifies 
how many additional times the loop is to be iterated before another 
break is to occur. The breaJc operations have been described 
previously in the section on the B command. 

Given the following program, which incrcjases the value of the AC by 
increments of 1, the use of the breakpoint command may be illustrated. 
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*200 


0200 

7300 

CLA 

CLL 

0201 

1206 A, 

TAD 

ONE 

0202 

2207 B, 

ISZ 

CNT 

0203 

5202 

JMP 

B 

0204 

5201 

JMP 

A 

0205 

7402 

HLT 


0206 

0001 ONE 



0207 

0000 CNT 

,0 


A 

0201 



B 

0202 



CNT 

0207 



ONE 

0206 



0201B 



200G 

0201 

C 

(0;0000 



0201 

C 

(OjOOOl 



0201 

(0;0002 



4C 

0201 

(0;0007 




CODT has been loaded eind started. A breakpoint is inserted at 
location 0201 and execution stops here showing the AC initially set to 
0000 and the link 0. The use of the Proceed command (C) executes the 
program until the breakpoint is again encountered (after one complete 
loop) and shows the AC to contain a value of 0001. Again execution 
continues, incrementing the AC to 0002. At this point, the command 4C 
is used, allowing execution of the loop to continue 4 more times 
(following the initial encounter) before stopping at tlie breakpoint. 
The contents of the AC have now been incremented to 0007. 


M — OPEN SEARCH MASK 

Typing M causes CODT to open for modif iccition the location containing 
the current value of the search mask and print its contents. 
Initially the mask is set to 7777. It may be changed by opening the 
mask location and typing the desired value after the value printed by 
CODT then closing the location. 


LINE FEED — OPEN LOWER SEARCH LIMIT 

The word immediately following the mask storage location contains the 
location at which the search is to begin. Typing the LINE FEED will 
open for modification the first location after the mask, and its con- 
tents will be printed. Initially, the lower search limit is set to 
0001. It may be changed by typing the desired lower limit after that 
printed by CODT, then closing the location. 
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LINE FEED — OPEN UPPER SEARCH LIMIT 


The next sequential word contains the location with which the search 
is to terminate. Typing the LINE FEED key to close the lower search 
limit causes the upper search limit to be opened for modification and 
its contents printed. Initially, the upper search limit is the 
beginning of CODT itself, 7000 (1000 for low version). It may also be 
changed by typing the desired upper search limit after the one printed 
by CODT, then closing the location with the RETURN key. 


nnnnW — WORD SEARCH 

The commcind nnnnW (where nnnn is eui octal number) will cause CODT to 
conduct a search of a defined section of core, using the mask and the 
lower and upper limits which the user has specified, as indicated 
above. The searching operations are used to determine if a given 
quantity is present in any of the locations of a particular section of 
memory . 


The search is conducted as follows: CODT masks the expression nnnn 
which the user types preceding the W and saves the result as the 
quantity for which it is searching. CODT then masks each location 
within the user's specified limits with C (M) and compares the result 
to the quantity for which it is searching. If the two quantities are 
identical, the address and the actual unmasked contents of the 
matching location are printed and the search continues until the upper 
limit is reached. The search occurs in the memory field specified by 
F. 


A search never alters the contents of any location. For excimple: 
Search location 3000 to 4000 for all ISZ instructions regardless of 
what location they refer to (i.e. search for all locations beginning 
with cin octal 2) . 


FOOlO 

20 

Set the field to 

2 



M7777 

7000 

Change the mask 
search limit. 

to 7000, 

open 

lower 

7453/0001 

3000 

Change thci lower 
upper limit. 

limit to 

3000, 

open 

7454/7000 

4000 

Change the upper 
location. 

limit to 

4000, 

close 

2000W 


Initiate the 

instructions. 

search 

for 

ISZ 

0200/2467 

3057/2501 


These are 4 ISZ 

instructions 

in 


3124/2032 


this section of 

core. 




7.3 ILLEGAL CHARACTERS 

Any character that is neither a valid control character nor an octal 
digit, or is the fifth octal digit in a sequence, causes the current 
line to be ignored and a question mark printed. For example; 
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CODT opens no location 


4:? 

4U? 

0406/4671 67K CODT ignores modification cind closes 

/4671 location 406. 


7.4 ADDITIONAL TECHNIQUES 


7.4.1 TTY I/O- FLAG 

CODT automatically notes the status of the TTY flag after encountering 
a breakpoint and restores it after performing a CONTINUE,. 


7.4.2 Interrupt Progrcim Debugging 

CODT executes an lOF when a brecOcpoint is encountered. (It does not 
do this when more iterations remain in an nnnnC command.) This is done 
so that cin interrupt will not occur when CODT prints the breakpoint 
information. CODT thus protects itself against spurious interrupts 
and may be used safely in debugging programs that turn on the 
interrupt mode. CODT restores the interrupt facility to its former 
state when it resumes execution. 


7.4.3 Octal Dump 

By setting the search mask to zero and typing W, all Locations (in 
field F) between the search limits will be printed on the Teletype. 


7.4.4 Indirect References 

When an indirect memory reference instruction is encountered, the 
actual address may be opened by typing 1' and (SIIIFT/N and SHIFT /O, 
respectively) . 


7.5 ERRORS 

The only legal inputs are control characters and octal digits. TVny 
other character will cause the character or line to be ignored and a 
question mark to be printed by CODT. Typing G alone is an error. It 
must be preceded by an address to which control will be transferred 
This will elicit no question mark also if not preceded by an address, 
but will cause control be transferred to location 0. 
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7.6 OPERATION AND STORAGE 

7,6,1 Storage Requirements - CAPS- 8 System 

CODT can be run in a standard CAPS-8 system and requires 1000 (octal) 
core locations and three locations (4,5,6) on page zero of every field 
which uses a breakpoint. CODT is page-relocatable. 

The source tape can be re-origined to the start of any memory page 
except page zero and assembled to reside in the four pages following 
that location, assuming they are all in the same memory bank. 


7.6,2 Programming Notes Summary 

CODT must begin at the start of a memory page (other than page zero) 
and must be completely contained in one memory field. 

The user's program must not use or reference any core locations 
occupied or used by CODT and vice versa. 

Breakpoints are fully invisible to "open location" commands; however, 
breakpoints may not be placed in locations which the user program will 
modify in the course of execution or the breakpoint will be destroyed. 

If a trap set by CODT is not encountered by the user's program, the 
breakpoint instruction will not be removed. 

The user may type CTRL/C at any time to return to the CAPS-8 Monitor 
(assuming his program did not destroy CAPS-8) . 
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7.7 COMMAND SUMMARY 


nnnn/ 

/ 

RETURN key 
LINE FEED key 

f (SHIFT/N) 

^ (SHIFT /O) 
Illegal character 

nnnnG 

nnnnB 

B 

A 

L 

C 

nnnnC 

M 

LINE FEED key 
LINE FEED key 
nnnnW 

F 

D 


Open location designated by the octal number 
nnnn. 

Reopen latest opened location. 

Close previously opened location. 

Close location and open the next sequential 
one for modification. 

Close location and allow immediate 
modification of the next location. 

Close location, take contents of that 
location as a memory reference and open it. 

Close location, open indirectly. 

Current line typed by user is ignored, CODT 
types: ? (CR/LF) , 

Transfer program control to location nnnn. 
Establish a breakpoint at location nnnn. 
Remove the breakpoint. 

Open for modification the location in which 
the contents of the AC were stored when the 
breakpoint was encountered. 

Open the location storing the link. 

Proceed from a breakpoint. 

Continue from a breakpoint and iterate past 
the breakpoint nnnn times before interrupting 
the user's program at the breakpoint 
location. 

Open the search mask. 

Open lower search limit. 

Open upper search limit. 

Search the portion of core as defined by the 
upper and lower limits for the octal value 
nnnn. 

Open location F. 

Open location D. 
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CHAPTER 8 

CAPS- 8 UTILITY PROGRAM 


8.1 INTRODUCTION 

The CAPS-8 Utility Program (UTIL) allows the user to take files stored 
on paper tape and transfer them to cassette, using either the 
high-speed or low-speed reader. The Utility Program will transfer 
both ASCII and BINARY files. 


8.2 CALLING AND USING THE UTILITY PROGRAM 

To call the Utility Program from the system cassette, the user types: 
.R UTIL/OPTIONS 

in response to the dot (.) printed by the Keyboard Monitor. 


8.2.1 Utility Program Options 

There are two options available for use with the Utility Program; 
these options are discussed in Table 8-1. (Options usage is explained 
in Chapter 2, Section 2.4.3.) 


Table 8-1 

Utility Program Options 

Option Meaning 

/H The /H option is used to designate the 

high-speed reader as the input device. Note 
that the high-speed reader is the default 
input device. That is, if no option is 
specified the program assumes that the 
high-speed reader is the input device. 

/L The /L option is used to designate the 

low- speed reader as the input device. 
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8,2.2 Input cind Output Specifications 

Before indicating the input cind output devices to be used in the file 
transfer, the user must ensure that the proper reader is ready and 
that the cassette the file is to be copied onto is write-enabled. 
When this has been done, the user is ready to begin the file transfer. 

After UTIL has been called from the system cassette, it asks the 
following: 


MODE- 

The user responds with a single character (A or B) to indicate whether 
the file being put on the cassette is ASCII or BINARY, 

OUT- 

The user responds by typing the drive number the output cassette is 
mounted on and the name of the output file to be put onto it, i.e,, 
3:F00. In B mode, .BIN is the default extension. 

After these two queries have been answered UTIL prints the following; 

The user responds by typing ciny character; this response starts the 
file transfer. (If /L had been typed, the user merely turns on the 
low-speed reader.) 


8.3 UTILITY PROGRAM ERROR MESSAGES 

Errors which occur during the Utility Program operation may be of two 
types: User errors and cassette errors. User errors may be corrected 
with the appropriate action as detailed in Table 8-2, Cassette errors 
normally require the user to use another cassette to complete the copy 
operation. Control does not return to the Keyboard Monitor when a 
Utility Progrcim error occurs. The user may use CTRL/C to return to 
the Monitor if he cannot correct the indicated error. 


Table 8-2 

Utility Progreun Error Messages 

Message Jteaning 

UNIT n NOT READY There is either no cassette on the cassette 

drive specified or no such drive exists. 

OUTPUT ERROR ON UNIT n An output error has occurred on the cassette 

drive specified. The user should try the 
trcuisfer operation using another cassette. 
Or perhaps, the user tried to write data when 
the write protect tab of the cassette on the 
drive specified was write- locked. 
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ENTER ERROR ON UNIT n An error occurred while trying to open a new 

cassette file. 

UNIT n FULL There was not enough room on the cassette. 

CLOSE ERROR ON UNIT n An error occurred during a close operation. 

INPUT ERROR In binary mode, the paper tape reader stopped 

or ran out of tape before a checksum was 
encountered. 

CHECKSUM ERROR In binary mode, the checksum did not agree; 

probably a hardware read error. Try again. 

Whenever ein error occurs, the program writes a new sentinel on the 

open cassette if possible. 
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CHAPTER 9 


BOOT 


BOOT is used to make it convenient to bootstrap from one system to 
another, or from, one device to another by typing commands on the 
keyboard. 

BOOT can run conveniently from CAPS-8 and other monitor systems, 
i.e., OS/8 and COS-300. 

9.1 OPERATING PROCEDURES 


To run BOOT from CAPS-8 the user types: 
.R BOOT 


the system will respond by typing a slash, at which time the user 
responds with the device mnemonic. 

If an illegal mnemonic is typed, the system types "NO" and prints a 
slash to allow the user to try again. In this case, the user can 
type RUBOUT to erase a line and try again. 

If a legal mnemonic was given, but the system configuration does not 
include the corresponding device (or the device is not ready) , the 
bootstrap may hang. 

The following is a list of legal mnemonics: 

Mnemonic Device System or Comments 


CA 

TA8E cassette 

CAPS-8 

DK 

Any disk (RF08, 
DF32, RK8E, RK8) 

OS/8, COS-300 

DL 

LINCtape 

DIAL-V2, DIAL-MS 

DM 

RF08 or DF32 

Disk Monitor 

DT 

Any tape (TC08, 
TD8E, LINCtape) 

OS/8, COS-300 

LT 

LINCtape 

OS/8, COS-300 

PT 

PT8E Papertape 

Loads BINLDR into field 0 
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Mnemonic 

Device 

System or Comments 

RE 

RK8E disk 

OS/ 8, COS- 300 

RF 

RF08, DF32 disks 

OS/8, COS-300 

RK 

RK8 disk 

OS/8, COS-300 

TD 

TD8E DECtape 

OS/8, COS-300 

TY 

TC08 DECtape unit 4 

Typeset Bootstrap 

types boot's version number 

TC 

TC08 DECtape 

OS/8, COS-300, Disk monitor, 
DEC library system, and others 

ZE 


Zeroes core (field 0) 


If the device mnemonic is followed by a period, the program will load 
the correct bootstrap into core and then halt. Hitting continue 
branches to the bootstrap. 

Example : 


BOOT 

/DT 


The preceding bootstraps onto a DECtape system (on DECtape unit 0 ) . 
The underlined characters were typed by the computer. 
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APPENDIX A 
ASCII CHARACTER SET 



8-Bit 

7-Bit 


8-Bit 

7-Bit 

Character 

Octal 

Octal 

Character 

Octal 

Octal 


A 

301 

101 

1 

241 

241 

B 

302 

102 

It 

242 

242 

C 

303 

10 3 

# 

243 

243 

D 

304 

104 

$ 

244 

244 

E 

305 

105 

% 

245 

245 

F 

306 

106 

& 

246 

246 

G 

307 

107 

1 

247 

247 

H 

310 

110 

( 

250 

250 

I 

311 

111 

) 

251 

251 

J 

312 

112 

* 

252 

252 

K 

313 

113 

+ 

253 

253 

L 

314 

114 


254 

254 

M 

315 

115 

- 

255 

255 

N 

316 

116 

• 

256 

256 

0 

317 

117 

/ 

257 

257 

P 

320 

120 

: 

272 

272 

Q 

321 

121 

i 

273 

273 

R 

322 

122 

< 

274 

274 

S 

323 

123 

= 

275 

275 

T 

324 

124 

> 

276 

276 

U 

325 

125 

7 

277 

277 

V 

326 

126 

@ 

300 


W 

327 

127 

[ 

333 

133 

X 

330 

130 

\ 

334 

134 

Y 

331 

131 

] 

335 

135 

Z 

332 

132 


336 

136 

0 

260 

260 


337 

137 

1 

261 

261 

Leader/Trailer 

200 


2 

262 

262 

BELL 

207 


3 

263 

263 

TAB 

211 


4 

264 

264 

LINE FEED 

212 


5 

265 

265 

FORM 

214 


6 

266 

266 

CARRIAGE RETURN 

215 


7 

267 

267 

CTRL/Z 

232 


8 

270 

270 

SPACE 

240 

240 

9 

271 

271 

RUBOUT 

377 





BLANK 

000 
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APPENDIX B 

ERROR MESSAGE AND COMMAND SUMMARIES 


The following summaries are provided for the user's convenience; they 
are grouped in alphabetical order according to the System Program to 
which they pertain. As these are only summaries the use.r is referred 
to the appropriate chapters for details. 


KEYBOARD MONITOR (Chapter 2) 


Error Messages 
Message 
BAD COMMAND 

FILE NOT FOUND 

10 ERROR ON UNIT n 

UNIT n NOT READY 

UNIT n WRITE IJOCKED 


Meaning 

The user has failed to follow the 
correct syntax for Monitor commands. 

The Monitor could not locate the file 
(or files) specified. 

An I/O error has occurred on the 
cassette unit drive specified. The 
user should try the I/O transfer 
specifying another cassett:e. 

There is no cassette on the unit 
drive specified, or no such drive 
exists . 

The user tried to write data when the 
write protect tab of the cassette on 
the drive specified was write-locked. 


Commands 

Command 

DATE 

DELETE 

DIRECTORY 


Explanation 

Allows the user to enter the month, 
day, and year. This date is then 
represented in directory Listings. 

Causes the file named in the command 
line to be deleted from the cassette 
drive specified. 

Causes a directory listing of the 
cassette specified in the command 
line. 
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KEYBOARD MONITOR (Con ' t) 


Command 

LOAD 


REWIND 


RUN 


VERSION 


ZERO 


Explanation 

Instructs the Monitor to load the 
file(s) specified in the command 
line. (The correct starting address 
is then set in the switch register 
and execution is started by pressing 
CONTinue. ) 

Causes the cassette on the drive 
specified to be rewound to its 
beginning. 

Instructs the Monitor to load and 
execute the file(s) specified in the 
command line. 

Causes the version number of the 
Monitor currently in use to be 
printed on the console terminal. 

Causes deletion of all files 
following the filename specified in 
the command line. If no filename is 
indicated, all files are deleted and 
the sentinel file is moved to the 
beginning of the cassette. 


EDITOR (Chapter 3) 

Error Messages 

Error codes are printed in the form ?niC where n represents one 
of the following: 

Code Meaning 

0 The EDITOR failed in reading from a 

device. An error occurred in the 
device handler; most likely a 
hardware malfunction. 

1 The EDITOFl failed in writing onto a 

device; generally a hardware 
malfunction. 

2 A file close error occurred. The 

output file could not be closed. 

A question mark (?) may appear any time the EDITOR encounters a 
syntax error. 
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In addition, the EDITOR contains the following error message: 


Message Meaning 

UNIT HAS OPENED FILE Two files cannot be open on the same 

cassette at the same time:. 


Commands 

Command 

A 


B 

C 

D 

E 


F 

G 

I 

J 

K 


L 


M 


N 


Meaning 

Append text from the keyboard to 
whatever is present in the text 
buffer. 

List the number of avaiJ.able memory 
locations in the text buffer. 

Change the text of a speicified line 
or lines. 

Delete the specified line!(s) from the 
buffer. 

Output the current buffer and 
transfer all input to the output 
file; close the output file. 

Find the next occurrence of the 
string currently being sciarched for. 

Get and list the next line which has 
a label associated with :Lt. 

Insert text before a specified line 
in the text buffer. 

Initiate an inter-buffer search for a 
character string. 

Kill the buffer; resei the text 
buffer pointers so that there is no 
text in the buffer. 

List entire contents (or specified 
lines) of the text buffer on console 
terminal. 

Move specified lines from one place 
in the text to another, deleting the 
old occurrence of the text. 

Write the current buffer to the 
indicated output file, kill the 
buffer and read the next logical page 
from the input file. 
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EDITOR (Con't) 


Command 

P 


Q 


R 


S 

V 

Y 

$ 


. = or . : 
/= or /: 


> 


LINE FEED 
Key 


Meaning 

Write the entire text buffer (or 
specified lines) to the output 
buffer. 

Immediate end-of-file. Q causes the 
text buffer to be output to the 
output file and the file closed. 

Read from the specified input device 
and append the new text to the 
current contents of the buffer. 

Search for the character specified. 

List the entire text buffer (or only 
specific lines) on the line printer. 

Skip to a logical page in the input 
file, without writing any output. 

Perform a search for a specified 
string of characters. 

List the current line number (,=) or 
list the last line number in the text 
buffer (/=) . 

List the next line in the text buffer 
on the console terminal. 

List the previous line in the text 
buffer on the console terminal. 

List the next line in the text buffer 
on the console terminal. 


SYSCOP (Chapter 4) 

Error Messages 

Message Meaning 

INPUT ERROR ON UNIT n An input error has occurred on the 

cassette unit specified. The user 
should try the copy operation using 
another cassette, 

UNIT n NOT READY There is no cassette on the unit 

drive specified, or no such drive 
exists . 
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SYS COP (Con't) 


Message Meaning 

UNIT n WRITE LOCKED The user tried to write data when the 

write protect tab of the cassette on 
the drive specified was write-locked. 

OUTPUT ERROR ON UNIT n An output error has occurred on the 

cassette unit specified. The user 
should try the copy operation using 
another cassette. 


PALC (Chapter 5) 
Error Messages 
Error Code 
BE 

DE 


Explanation 

Two PALC Internal tables have 
overlapped. Fatal error. 

An error was detected when trying to 
read or write a device. 


DF 


Device full. 


IC Illegal character. The character is 

ignored and assembly continues. 


ID Illegal redefinition of a symbol. 



The symbol 

retains 

its old 


definition . 



IE 

Illegal equals. 

An equal 

sign was 


used in the wrong 

f context . 


II 

Illegal indirect. An 

off-page 


reference was made. 

IP Illegal pseudo-op. A pseudo-op was 

used in the wrong context or with 
incorrect syntax. 

IZ Illegal page zero reference. The 

pseudo-op Z was found in an 
instruction which did net refer to 
page zero. The Z is ignored. 

PE Current non- zero page exceeded. An 

attempt was made to: 

1. Override a literal with an 
instruction 
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PALC (Con't) 


Error Code 

PH 

RD 

SE 

UO 

US 

ZE 

BASIC (Chapter 6) 
Error Messages 
Message 

ARGUMENT ERROR 

CHAIN ERROR 

DATA ERROR 

EOF ERROR 

EXPRESSION ERROR 


Meaning 

2. Override an instruction with a 
literal 

3, Use more literals than the 
assemhiler allows on that page 

Phase error. Either no $ appeared at 
the end of the program, or < and > in 
conditional pseudo-ops did not match. 

Redefinition. A permanent symbol has 
been defined with =. The new and old 
definitions do not match. The 
redefinition is allowed. 

Symbol table exceeded. Too many 
symbols have been defined for the 
amount of memory available. 

Undefined origin. An undefined 
symbol has occurred in an origin 
statement. 

Undefined symbols. A symbol has been 
processed during pass 2 that was not 
defined before the end of pass 1. 

Page 0 exceeded. Same as PE except 
with reference to page 0. 


Meaning 

A function was given an illegal 
argument; for example: SQR(-l) . 

A cassette error occurred while doing 
program chaining. 

There were no more items in the data 
list. 

The user attempted to read past the 
end-of-file during run-time input. 

One of BASIC's internal lists 
overflowed while attempting to 
evaluate an expression. 
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BASIC (Con't) 


Message 

FILE NAME ERROR 

FILE OPEN ERROR 

FOR ERROR 
FUNCTION ERROR 

GOSUB ERROR 
I 0 ERROR 

IN ERROR 

LINE TOO LONG 

LINE # ERROR 

LOOKUP ERROR 

NEXT ERROR 

NO FILES ERROR 

OUT ERROR 

RETURN ERROR 


Meaning 

A mistake was found in the user's 
specification of a cassette drive # 
or filename in either a CHAIN or an 
OPEN stateiment. 

The user attempted to open a run-time 
output file when one was already 
open, or a hardware error occurred. 

FOR loops were nested too deeply. 

The user cittempted to call a function 
which had not been defined. 

Subroutine's were nested too deeply. 

The user attempted to do run-time 
input and output to the same cassette 
at the same time, 

A cassette error occurred while 
attempting to carry out an OLD 
command or while doing run-time 
input. 

A line greater than 80 characters in 
length was typed; BASIC ignores the 
line and waits for a new one to be 
entered. 

A GOTO, GOSUB, or IF statement 
referenced a nonexistent line. 

BASIC could not find a run-time input 
file on the drive specified. 

FOR and NEXT statements were not 
properly paired. 

The user attempted to do run-time 
file I/O without first specifying so 
during BASIC's initial dialogue. 

An error (probably end-of-tape) 
occurred while doing cassette output 
either during a SAVE or during 
run-time output. 

A RETURN statement was issued when 
not under control of a GOSUB. 
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BASIC (Con't) 


Message 


Meaning 


SUBSCRIPT ERROR A subscript was used which was 

outside the bounds defined in the DIM 
statement. 


SYNTAX ERROR A command did not correspond to the 

language syntax, or an undefined UUF 
was referenced. 

TOO BIG, LINE IGNORED The combination of program size and 

number of variables exceeded the 
capacity of the computer. 


Statements 

Statement 

CHAIN 

CLOSE 

COMMAS 

DATA 

DEF 

DIM 

END 

FOR-TO-STEP 

GOSUB 

GOTO 

IF~END#-THEN 


IF-GOTO 

IF-THEN 


Meaning 

Link to next user program. 

Close open output file. 

Output data values to a cassette 
inserting a comma between each value. 

Set values for a READ. 

Define a function. 

Dimension subscripted variables. 

Signals the end of program execution. 

Set up a program loop; increment the 
counter by a value specified using 
STEP. 

Transfer control to a subroutine. 

Transfer control to the line number 
specified in the command line. 

Transfer control (or perform an 
operation) depending upon the 
validity of the last INPUT# 
statement. 

Transfer control (or perform an 
operation) depending upon the 
relationship between variables 

specified in the command line. 
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Statement 

Meaning 

INPUT 

Input values from the console 

terminal. 

INPUT# 

Input values from a data file. 

LET 

Assign a value to a variable. 

LIST 

List program (or specific lines) on 
console terminal. 

LIST# 

List program (or specific lines) on 
line printer. 

LPT 

Send output to the line printer. 

NAME 

Rename the program in memcry. 

NEW 

Specify a new prograim name. 

NEXT 

Continue a program loop' until a 

terminating value is reached. 

NO COMMAS 

Terminate outputting of commas. 

NO RUBOUT 

Disable the RUBOUT command. 

OLD 

Call saved program from cassette into 
memory . 

OPEN FOR INPUT/OUTPUT 

Open a file on cassette for input or 
output. 

PRINT 

Print values or specified text on the 
console terminal. 

PRINT# 

Output values to a data file. 

READ 

Read values from a data list. 

REM 

Insert remarks or comments in the 
program. 

RESTORE 

Reset DATA value to its original 
value. 

RETURN 

Return from a subroutine to the main 
body of the program. 

RUBOUTS 

Allow the use of the RUBCUT key to 
delete characters. 

SAVE 

Save the program in memcry on the 
cassette to be specified. 
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BASIC (Con*t) 


Statement 

SCR 

STOP 

TTY OUT 


Meaning 

Delete th€5 current progrcim in memory. 

Transfer control to the END 
statement. 

Return output to the console terminal 
(after using LPT) , 


Functions 


Function 

Meaning 


SIN(x) 

Sine of x 


COS (x) 

Cosign of x 


TAN(x) 

Tangent of x 


ATN(x) 

Arctangent of x 


EXP (x) 

Exponenticil value of x 


LOG(x) 

Natural log of x 


SGN (x) 

Sign of x 


INT(x) 

Integer value of x 


ABS(x) 

Absolute' value of x 


SQR{x) 

Square root of x 


RND(x) 

Generate a random number 


TAB(x) 

Print character at space 

X 

GET(x) 

Get character from input 

device 

PUT(x) 

Put character on output ( 

device 

FNA(x) 

User-defined function 


UUF(x) 

User-coded function 
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APPENDIX C 

PALC PERMANENT SYMBOL TABLE 


The following are the most commonly used elements of the PDP-8 
instruction set and are found in the permanent symbol table within the 
PALC assembler. For additional information on these instructions and 
for a description of the symbols used when programming other, 
optional, I/O devices, see THE SMALL C0M1>UTER HT^NDBOOK, available from 
the DEC Software Distribution Center. (All times are in microseconds 
and respresentative of the PDP-8/E.) 


Mnemonic Code Operation Time 


Memory Reference Instructions 


AND 

0000 

Logical AND 

2.6 

TAD 

1000 

Two's complement add 

2.6 

ISZ 

2000 

Increment and skip if zero 

2.6 

DCA 

3000 

Deposit and clear AC 

2.6 

JMS 

4000 

Jump to subroutine 

2.6 

JMP 

5000 

Jump 

1.2 

Mnemonic 

Code 

Operation 

Sequence 


Group 1 Operate Microinstructions (1 cycle = 1.2 microseconds) 


NOP 

7000 

No operation 




— 

lAC 

7001 

Increment AC 




3 

RAL 

7004 

Rotate AC and 

link 

left 

one 

4 

RTL 

7006 

Rotate AC and 

link 

left 

two 

4 

RAR 

7010 

Rotate AC and 

link 

right 

one 

4 

RTR 

7012 

Rotate AC and 

link 

right 

two 

4 

CML 

7020 

Complement link 



2 

CMA 

7040 

Complement AC 




2 

CLL 

7100 

Clear link 




1 

CLA 

7200 

Clear AC 




1 

BSW 

7002 

Swap Bytes in 

AC 



4 


C-1 



Mnemonic Code 


Operation 


Sequence 


Group 2 Operate Microinstructions (1 cycle) 


HLT 

7402 

Halts the computer 

3 

OSR 

7404 

Inclusive OR SR with AC 

3 

SKP 

7410 

Skip unconditionally 

1 

SNL 

7420 

Skip on nonzero link 

1 

SZL 

7430 

Skip on zero link 

1 

SZA 

7440 

Skip on zero AC 

1 

SNA 

7450 

Skip on nonzero AC 

1 

SMA 

7500 

Skip on minus AC 

1 

SPA 

7510 

Skip on positive AC (zero is positive) 

1 


Combined Operate Microinstructions 


CIA 

7041 

Complement and increment AC 

2,3 

STL 

7120 

Set link to 1 

lr2 

GLK 

7204 

Get link (put link in AC, bit 11) 

1,4 

STA 

7240 

Set AC to “1 

2 

LAS 

7604 

Load AC with SR 

2,3 


MQ Microinstructions 


MQL 

7421 

Load MQ from AC, then clear 

MQA 

7501 

Inclusive OR the MQ with AC 

CAM 

7621 

Clear AC and MQ 

SWP 

7521 

Swap AC and MQ 

ACL 

7701 

Load MQ into AC 


Internal lOT Microinstructions 


SKON 

6000 

ION 

6001 

lOF 

6002 

SRQ 

6003 

GTF 

6004 

RTF 

6005 

SGT 

6006 

CAF 

6007 


Skip if interrupt ON, cind turn OFF 
Turn interrupt processor on 
Disable interrupt processor 
Skip on interrupt request 
Get interrupt flags 
Restore interrupt flags 
Skip on greater than flag 
Clear all flags 


C-2 



Mnemonic Code 


Operation 


Keyboard/Reader (1 cycle) 

KSF 6031 Skip on keyboard/reader flag 

KCC 6032 Clear keyboard/reader flag and AC; 

set reader run 

KRS 6034 Read keyboard/reader buffer (static) 

KRB 6036 Clear AC, read keyboard buffer 

(dynamic) , clear keyboard flags 
KCF 6030 Clear keyboard/ reader 

KIE 6035 AC 11 to keyboard/reader interrupt 
enable F.F, 


Teleprinter/Punch (1 cycle) 

TSF 6041 Skip on teleprinter/punch flag 

TCF 6042 Clear teleprinter/punch flag 

TPC 6044 Load teleprinter/punch and print 

TLS 6046 Load teleprinter/punch, print, and clear 
teleprinter/punch flag 
TFL 6040 Set teleprinter/punch flag 

TSK 6045 Skip on printer or keyboard flag 


Line Printer (1 cycle) 

LSF 6661 Skip on character flag 

LCF 6662 Clear character flag 

LSE 6663 Skip on error 

LPC 6664 Load printer buffer; print on full buffer or 

control character 

LIE 6665 Set program interrupt flag 

LLS 6666 Clear line printer flag, load character 

and print 

LIF 6667 Clear program interrupt flag 


Cassette (1 cycle) 

KCLR 6700 Clear all 

KSDR 6701 Skip on data flag 

KSEN 6702 Skip on error 

KSBF 6703 Skip on ready flag 

KLSA 6704 Load status A from AC 4-11, clear 

AC, load 8-bit complement of 
status A 

KSAF 6705 Skip on any flag or error 

KGOA 6706 Assert the contents of status A, 

transfer data if read or write 
KRSB 6707 Read status B into AC 4-11 
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Mnemonic Code 


Operation 


Memory Extension Control, Type MC8/E (1 cycle) 


CDF 

62N1 

Change to data field N 

CIF 

62N2 

Change to instruction field N 

RDF 

6214 

Read data field 

RIF 

6224 

Read instruction field 

RIB 

6234 

Read interrupt buffer 

RMF 

6244 

Restore memory field 

CDI 

62N3 

Change to data field and instruction 


PSEUDO-OPERATORS 

The following is a summary of the PALC assembler pseudo-operators and 
a brief description of their functions. Detailed information 
concerning these pseudo-ops is contained in Chapter 5 . 


DECIMAL 

OCTAL 

FIELD 

I 

Z 

EXPUNGE 

FIXTAB 

PAGE 

XLIST 

IFDEF 

IFNDEF 

IFZERO 

IFNZRO 

FIXMRI 

ENPUNCH 

NOPUNCH 

ZBLOCK 

EJECT 

TEXT 


Causes all following numbers to be interpreted as 
decimal. 

Causes all following numbers to be interpreted as 
octal. 

Causes a field setting. 

Represents indirect addressing. 

Denotes a page zero reference. 

Deletes the entire permanent symbol table. 

Appends presently defined symbols to the permanent 
symbol table. 

Resets the location counter to the next page. 
Suppresses listing while continuing assembly; a 
second XLIST continues listing. 

If the symbol is defined, the code within brackets 
is assembled. 

If the symbol is not defined, the code within 
brackets is not assembled. 

If the expression is zero, the code within brackets 
is assembled. 

If the expression is not zero, the code within 
brackets is not assembleid. 

Defines a memory reference instruction. 

Resumes binary output after NOPUNCH. 

Continues assembling code but stops binary output. 
Reserves words of memory. 

Causes the listing to jump to the top of the next 
page. 

Allows a string of text characters to be entered. 
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APPENDIX D 

SYSTEM DEMONSTI^TION RUN 


The following example run, in which the user creates a binary and 
listing file from an ASCII source file, illustrates a typical use of 
the CAPS-8 System. The machine output is coded by letters in the left 
margin which correspond to the textual explanations found following 
the run , 

c _.DA 01/04/7 3 

_.DI I 

01/04/73 
FILE .BIN 

MAfH .DAT lB/17/72 V2 

j>_z 1 

_.rt FALC 

-INPUT FILES 
: TEST. PAL 

-binaky file 
-list to 

JlLPT 

US STArtT 
US L2 60 ■*•0001 


B 




r KCLR»6700 PALC«»V1 01/04/73 PAGE 1 



6700 

KCLR»6700 


6701 

KSDR*670l 


6702 

KSENB6702 


6703 

KS8F»6703 


6704 

KLSA=6704 


6705 

KSAF*6705 


6706 

KGOA«6706 


6707 

KRSB*6707 


7002 

BSW«7002 


3602 

LOC«3602 


4000 

*4000 

US 

04000 

1000 

^ s 

start, tad 

04001 

1206 

CRCCHK, TAD L260 

04002 

6704 

KLSA 

04003 

6706 

KGOA 

04004 

6703 

KSBF 

04005 

5204 

RDCOO, JMP ,-l 

0400S 

7264 

L260, CML STA RAL 
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CL 0) c: D 


c 

0 
n 
t 

1 


US 

04007 

0000 



04010 

7610 


SKP 

CLA 

04011 

3211 


DCA 

• 

04012 

3636 


OCA 

I PTR 

04013 

1205 


TAD 

RDCOD 

04014 

6704 


KLSA 


04015 

6706 

LOOPf 

KGOA 


04016 

6701 


KSOR 

.-1-Aj/WA 

04017 

5216 


JMP 

04020 

7002 


BSm 

04021 

7430 


SZL 


040?2 

1636 


TAD 

I PTR 

04023 

7022 


CPU 

BSP 

04024 

3636 


DCA 

I PTR 

04025 

7420 


SNL 


04026 

2236 


ISZ 

PTR 

04027 

2235 


ISZ 

KNT 

04030 

5215 


JMP 

LOOP 

04031 

7346 


STA 

CLL RTL 

04032 

7 002 


BSP 


04033 

3235 


OCA 

KNT 

04034 

5201 


JMP 

CRCCHK 

04035 

7737 

KNT, 

7737 


04036 

3557 

PTK, 

LOC- 

23 

04037 

7730 

H5K, 

-50 



KCLK»6700 

CKCCHK 
K K! T a H ■< 5 


LOC 

LOOP 

LPfeO 

MSC* 

PTP 
POCOD 
ST APT 


36U2 

at^i5 

a006 

40 3 7 
4036 
4005 
4000 


/kOAO Jur6 srA. A 


PalL-VI 01/0«/73 page 1-1 


»C 

.rt EDIT 


♦ INPUT FILE- 2 :TEST.PAL 
♦OUTPUT FILE- 1 :TEST.pAL 
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r 



#.rt 



#$> 'L 

STAiiT> 

TAD Mri0 


# .S 

STAKT> 

TAD Fjh\50 


#. 7L 

KDEN 


JL^'^ 

KD\SEN 


_£»L 

KSEN 


±- 5S 

KLSA 

/LOAD INTO STA. 

‘j[$l"L 

JJXP .-1 /WAIT 

FOH DATA Fl^G 


JMP . - 1 


/WAIT FOri DATA FLAG 


r FALC/N 

-INPUT FILES 
*1 : TEST. PAL 
JL. 

“BINArtT FILE 
: TEST.8IN 
-LIST TO 


i.TTT 


BINA/iY 

FILE 

BINAKV 

FILE 

CRCCHK 

400 1 

KlMT 

4035 

LOG 

3602 

LOOP 

40 1 5 

L2 60 

4006 

M50 

4037 

PTR 

4036 

RDCOD 

4005 

START 

4 000 

2£- 


rC 


iDEL 2: 

TEST 


D-3 



A The Keyboard Monitor is loaded and the DAte command is used to 
indicate the current date. The user requests a directory 
listing of cassette drive 1; he decides to zero the directory, 
thereby deleting all files present on the cassette. 

B PALC is called from the System Cassette. The input file, 
TEST. PAL, is stored on cassette drive 2. The user decides to 
specify as output only a listing on the line printer. Two 
errors are flagged by the assembler and printed on the console 
terminal during its second pass. 

C The listing is printed on the line printer. The user then 
marks this listing with appropriate corrections and insertions, 

D PALC prints a -fC; the user makes sure that the System Cassette 
is still mounted on drive 0 and then types a tC to cause 
control to return to the Monitor. 

E The Editor is next called from the System Cassette so that the 
errors in the file TEST. PAL may be corrected. The input is 
again drive 2, and the output file will be sent to the 
previously zeroed cassette on drive 1, 

F The R command brings in the first page of text and the 

intra-buffer search is used to find the first error. This 
misspelling is corrected using the single character search 
command and the rubout character, 

G The next mistake occurs 7 lines further in the listing; the 

incorrect character is foxand and corrected. The line is also 
listed to make sure the correction was made properly. 

H The user inserts a comment in the 5th line forward from this 
line by skipping ahead 5 lines, searching for the A, and then 
adding the comment to the line. 

I The intra-buffer search is used to locate the next correction; 
a tab is inserted between the 1 and the tab already present, 

J The file is closed. 

K The user calls PALC again, specifying the edited file on drive 

1 as the input. The /N option is used to obtain only a listing 
of the symbol table; the binary file is output to drive 2, and 
the symbol tcible is listed on the console terminal. 

L After assembly, PALC prints -tC and waits while the user makes 
sure the System Cassette is mounted on drive 0. He then types 
iC and control returns to the Monitor. The user deletes the 
first input file (the uncorrected TEST, PAL) from the cassette 
on drive 2 to complete his session. 
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APPENDIX E 
MONITOR SERVICES 


Included in this Appendix is information the user needs if he intends 
to create files using the PAL machinci language or reference system 
device hcindlers. 


E.l MONITOR MEMORY MAP 

The CAPS-8 Keyboard Monitor occupies the following memory locations; 
if the user's program does not overwrite these areas of memory, the 
routines they contain will be available for use from within his 
program and the Monitor may be restarted after execution, (Section 
E,2 provides more information concerning these routines.) 


Table E-1 Monitor Memory Map 


Address 

Contents 


FIELD 0 

7400 

7600 

LPT and Console Terminal Handlers 

Bootstrap, KBD Handler, Interrupt Routine 



FIELD 1 


5200-6200 

Keyboard Monitor 

and Commands 

6200 

WAIT and part of 

Cassette HANDLER 

6400 

CLOSE and ENTER 


6600 

Cassette HANDLER 


7000 

LOOKUP 


7200 

UTIL and part of 

Cassette HANDLER 

7400 

Binary Loader 


7600 

Buffer 


E.2 MONITOR SERVICE UTILITY SUBROUTINES 


The user may direct his 

program to one 

of the following utility 

subroutines providing 

the routine has 

not been overwritten or 

otherwise destroyed. 




Table 

E-2 Utility 

Subroutines and Locations 

Address Name 

Location 

Service 


LPOCHR 07400 This routine is used to print a 

character on the line pi'inter. The 
calling sequence is; 
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Teible E-2 Utility Subroutines and Locations (Cont*d) 


Address Name Location 


Service 


TTOCHR 


LPPUTP 

LPGETP 

LPCHCT 

ECHO 

TTSIZ 

TTPUTP 

TTGETP 


CDF (current field) 

CIF 0 

TAD character 
JMS I (LPOCHR 

The character in bits 5-11 of the AC 
is added to the line printer ring 
buffer to be printed, 

07402 This routine is used to print a 
character on the console terminal. 
The calling sequence is; 

CDF (current field) 

CIF 0 

TAD character 
JMS I (TTOCHR 

The character in bits 5-11 of the AC 
is added to the teleprinter ring 
buffer to be printed. (The character 
will not print if ECHO is off at the 
time, but can be designated as a 
"must print" character by turning AC 
bit 3 on. This causes the character 
to force ECHO on.) 

07404 This address contains the next free 
location in the line printer buffer, 

07405 LPGETP contains the previous location 
which was output in line printer 
buffer (never a pointer) . 

07406 This location contains the number of 
line printer interrupts yet to be 
expected, 

07407 If this address contains -1, ECHO is 
off (no ECHO); if it is set to 0, 
ECHO is on. 

07410 This address contains the length of 
the teleprinter ring buffer (number 
of characters it can hold) . 

07411 TTPUTP contains the next free 

location in the teleprinter output 
buffer. 

07412 This address contains the last 

location which was output in the 
teleprinter buffer (never a pointer) , 


E-2 





Table E-2 Utility Subroutines cind Locations (Cont'd) 


Address 

TTCHCT 

LPSIZ 

MON RES 


KBDFLG 

KBDIN 

BREAK 

CTRLCJ 


Name Location Service 


07413 TTCHCT contains the number of 

teleprinter interrupts yet to be 
expected. 

07414 This location contains one less than 
the length of the line printer ring 
buffer (number of characters it can 
hold -1). 

07415 MONRES is the location in field 0 
which can be branched to in order to 
restart the Keyboard Monitor in 
memory (assuming the Keyboard Monitor 
has not been destroyed) , Control 
jumps from this location to the 
routine MON , 

07600 Branching to this location causes a 
complete rebootstrap of the Keyboard 
Monitor from the System Cassette on 
drive 0. If an I/O error occurs or 
if the cassette on drive 0 does not 
contain the file MONTOR.BIN, the 
system waits for the user to mount a 
good Syst( 2 m Cassette; typing a CTRL/C 
will then rebootstrap. 

07601 If this location contains a non-zero 
number, it signifies that a character 
(other than CTRL/0 or BREAK) was 
typed on the keyboard and has not yet 
been read. It is lost if a second 
character gets typed before the 
previous one is read. 

07602 This location contains the last 
character typed on the keyboard. 
(Here BREi\K and CTRL/0 do count.) 

07603 This location contains a 1 if a BREAK 
has not been used; 0 if it has. 

07604 If this location is 0, then whenever 
CTRL/C is typed, the Monitor will 
branch to 07600 and bootstrap (after 
the current cassette operation 
finishes). If not 0, then when the 
current cassette operation finishes , 
control is transferred (with 
interrupts on) to this location in 
field 0. Set this to point to MONRES 
if the Keyboard Monitor has not been 
destroyed. 
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Table E-2 Utility subroutines and Locations (Cont'd) 


Address Name 


KBDCHR 


Location Service 


07605 Same as 07600. 

07626 This routine reads a character from 

the keyboard. It waits for KBDFLG to 
be non-zero, then zeroes it and 
returns the contents of KBDIN in the 
AC. The calling sequence is: 

CDF (current) 

CIF 0 

JMS I (KBDCHR 


DISMIS 

INTRPT 

LPBUFR 

TTBUFR 

MON START 


MON 


WAIT 


07645 The system branches to this location 

to dismiss an interrupt. 

07657 The interrupt routine begins at this 

address . 

07731 LPBUFR is the start of the default 

line printer ring buffer (initially 
of length 2) . 

07734 TTBUFR is the Start of the default 

teleprinter ring buffer (initially of 
length 30) . 

15200 Branching to this location starts the 
Monitor, assuming that the entire 
Monitor is still in memory. The 
routine waits for TTY and LPT then 
resets buffers to defaults and 
empties them. Sets CTRLCT to point 
to MONRES. Sets ECHO on and sets 
BREAK to 1. Notes cassettes as not 
being in use. 

15201 This routine restarts the Monitor but 
does not do any of above. 

15400 Starting at this location also 

restarts the Monitor and resets 
locations that may be in a temporary 
state if the Monitor has been stopped 
(e.g., by hitting STOP) prematurely. 

16200 This routine waits for the last 

cassette operation (if there was one) 
to complete. The calling sequence 
is : 
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T£±>le E-2 Utility Subroutines and Locations (Cont'd) 


Address 


CINUSE 


ESTATE 


CLOSE 


BACK 


ENTER 


Name Location 


Service 


CDF (current) 

CIF 10 

JMS I (WAIT 

<error return > 

<normal return > 

If an error return is taken, bit 0 
may be on and bits 4-11 will contain 
the contents of status register B at 
the time of error. This routine 
should be called sometime after every 
call to HAl'JDLER. 

16273 If this location contains a 0, 
cassettes are ready; 1 means 
cassettes are in use; -1 means 
cassettes had an error in a previous 
operation. 

16274 This location contains the status of 
register B at termination of cassette 
operation. 

16400 Calling this subroutine terminates an 

output file and writes a new sentinel 
file at the end of the cassette. The 
calling sequence is; 

TAD (UNIT 

CDF (current field) 

CIF 10 

JMS I (CLOSE 
< error return > 

< normal return> 

The error return is taken only if an 
end-of-tape is encountered before the 
sentinel file is successfully 
written. 

16402 This routine positions the cassette 

so that the header record of the 
current file may be written over. 
The calling sequence (fj.eld 1 only) 
is; 

JMS I (BACK 
< error return> 

< normal return> 

16404 Calling this subroutine opens a new 

file on a cassette. The calling 
sequence is; 
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Table E--2 Utility Subroutines and Locations (Cont'd) 


Address 


HANDLER 


Name Location 


Service 


TAD (UNIT 

CDF (current field) 

GIF 10 

JMS I (ENTER 
<error return > 

<normal return > 

where UNIT is the cassette unit drive 
number. Before making this call, the 
user must set up the new filename in 
an in-core header record known as the 
SINCH. ENTER automatically puts the 
date and record size into the SINCH 
for the user, (The SINCH format is 
described in Section E,4), The 

INCH is destroyed, 

16600 This routine calls the system 
cassette handler which is resident 
cuid will be used by all system 
programs. The handler routine is 
also availcible to any user who does 
not load over it. Before calling 
this handler, the user must ensure 
that the cassette is correctly po- 
sitioned, See also LOOKUP, ENTER, 
and CLOSE, The calling sequence is: 

CDF (current field) 

CIF 10 

TAD (UNIT 

JMS I (HANDLER 

ARGl (function control word) 

ARG2 (buffer address) 

< error return > 

<normal return > 

The unit number is left in the AC, 
Only bits 8-11 are used (units 0-17 
octal). However, to specify unit 0, 
at least one other bit (of bits 0-7) 
must be on. It is more convenient, 
therefore, to leave the unit number 
as a character in the AC (0-9 would 
be 60-71) , A real 12-bit 0 in the AC 
means use the previous unit, (The 
initial unit is 0,) 

The function control word has the 
following form: 

Bit 0: 0 means read 

1 means write 
Bits 6-8: field of buffer 
Other bits are ignored. 
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Tcible E-2 Utility Subroutines and Lcoations (Cont'd) 


Address Name Location 


Service 


BSIZE 

LOOKUP 


17000 

17002 


The length of the record (in 8-bit 
bytes) must have been previously 
stored in location BSIZE, The 
specified record size must be between 
1 auid 377. LOOKUP and ENTER return 
with BISZE set to 200 (octal ) , the 
usual record size. 


If an error return is made, the AC 
bits 4-11 specify the contents of 
status register B when the error 
occurred. These bits are summarized 
below: 


bit 4: 
bit 5: 
bit 6 : 
bit 7: 
bit 8 : 
bit 9: 
bit 10: 
bit 11: 


CRC /block error 
timing error 
EOT/BOT 
EOF 

drive empty 
rewind 

write lock out 
ready 


Bit 0 of the AC will be a 1 if the 
error occurred on the previous 
handler call as opposed to the 
current handler call. This is 
because the handler will wait (by 
calling WAIT) if it is called while 
it is already in use. The user can 
manually wait for the cassette 
operation to be completed by calling 
WAIT, If an error occurs, bit 0 of 
the AC will always be on in this 


case. 


The user may check to see if the 
handler is in use without waiting by 
interrogating the location CINUSE, 
Non-zero means that the handler is in 
use. Two successive calls to HANDLER 
should not be made v^ithout an 
intervening call to WAIT. 

This location contains the current 
record size. 

Calling this subroutine positions a 
cassette at a specified file to be 
read. The calling sequence is: 
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Table E-2 Utility Subroutines and Locations (Cont'd) 


Address 


UTIL 


OPTl 
OPT 2 
OPT 3 


Name Location 


Service 


17200 


17400 

17401 

17402 


TAD (UNIT 
CDF FROMFLD 
GIF 10 

JMS I (LOOKUP 
CDF (filename fid) 
ptr to filename 
<error return > 

<not found return > 
< found return > 


UNIT represents the cassette unit 
drive number. The header is put in 
the INCH. The filename consists of 
11 consecutive ASCII characters. 


This routine allows the user to 
specify that a utility operation be 
performed. The user must be famil- 
iar with the hardware specifications 
as described in the TU60 CASSETTE 
TAPE TRANSPORT MAINTENANCE MANUAL 
(DEC-00-TU60-DA) to understand what 
these operations do and what 
conditions cause errors. The calling 
sequence is: 

CDF n 
CIF 10 
TAD (UNIT 
JMS I (UTIL 
utility code 
<error return > 

<normal return> 


The following are legal utility 
codes; all other codes are illegal. 


10 rewind 

30 backspace file gap 
40 write file gap 
50 backspace block gap 
70 skip to file gap 


Switch option characters (e.g., /A) 
stored as 36 bits for A-Z , 0-9 as 
shown in diagram in Figure E-1. 
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Table E-2 Utility Subroutines and Locations (Cont'd) 


Address Name Location 


Service 


OPT 1 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

OPT 2 

M 

N 

0 

P 

Q 

R 

S 

T 

U 

V 

W 

X 

OPT 3 

Y 

Z 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 


Figure E-1 Switch Option Characters 


SINCH 

17403 

See ENTER. 

DATE 

17531- 

17540 

These locations contain 8 characters 
representing the date (e.g., 

01/22/73) . 

INCH 

17600 

See LOOKUP. 


E.3 RING BUFFERS 

Ring buffers must be located in upper core (4000-7777) of field 0. 
They consist of one or more buffer segments, each one of which 
consists of two or more consecutive locations (the last one pointing 
to the next segment) . The last segment points to the first one. Ring 
buffers can be changed by System Programs. 



Figure E-2 Ring Buffers 
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E.3.1 Modifying the Ring Buffers 


The initial ring buffer supplied by the Monitor consists of one buffer 
segment of length LPSIZE (TTSIZE) not counting the pointer. The first 
location is called LPBUFR (TTBUFR) and the last location is called 
LPBFND (TTBFND) . The value LPSIZE-1 (TTSIZE) is stored in the 
location LPSIZ (TTSIZ) . The buffer is initially empty. The next 
location free in the buffer is pointed to by LPPUTP (TTPUTP) and the 
previous location which has already been output is known as LPGETP 
(TTGETP) . Both these locations point only to positive words, never to 
negative pointers. LPCHCT (TTCHCT) is the ones complement of the 
number of characters left in the buffer to be output if I/O is still 
in progress. (Specifically, it is the number of flags which have yet 
to come up.) LPCHCT (TTCHCT) is zero (0) if there is no output in 
progress . 

To enlarge the ring buffer, wait until LPCHCT (TTCHCT) is zero. Then 
set LPBFND (TTBFND) to point to the start of the buffer and have the 
end of the buffer point to LPBUFR (TTBUFR) . Change LPSIZ (TTSIZ) to 
be the length of the buffer (length -1 in case of LPSIZ) not counting 
pointer words. Interrupts may be on while this is done providing no 
LPT (TTY) I/O is initiated. 


E.4 HEADER RECORD FILE STRUCTURE 

All files the user creates must begin with a header record (40 octal 
bytes long) , followed by 200 octal byte long records. The structure 
of a header record is as follows; 

TcdDle E-3 Header Record Structure 


Bytes (octal) Description 


1-6 Filename; may consist of any alphabetic character 

or digit cind is padded with spaces on the right. 

7-11 Filename extension; see Table 2-1 for recommended 

extension names. 

12 File type; maintained by the system for its 

convenience and for standard compatibility. File 
types are : 

1 ASCII file 

2 Standard DEC Binary File 

12 Bad file (Specified for all 

deleted files) 

Refer to Section 2.2.1 for an explanation of 
these file types. 

13-14 File record length; always has the value 0,200 

(i.e., 200) for compatability with standards. 

15 File sequence nuirfDer (not used) . 
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Tat>le E-3 Header Record Structure (Cont'cl) 

Bytes (octal) Description 

16 Header continuation byte; always 0. 

17-24 ASCII date stored as dd nun yy, or 6 spaces if no 

date was specified when the file was saved. This 
is the creation date of the file. 

25 File version number. New files are version 0 and 

are automatically incremented by the CAPS- 8 
EDITOR. 

26-40 Not used. 
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E.5 CAPS- 8 BOOTSTRAPS 


The CAPS-8 Hardware Bootstrap is used to load the Cassette Keyboard 
Monitor into memory. This bootstrap is stored in the computer in 
re ad- only-memory so that it is always available for use. Pressing the 
SW switch on the computer console causes this bootstrap to be 
executed; it calls the program C2B00T.BIN into memory from the System 
Cassette. The CAPS-8 Hardware Bootstrap is comprised of the following 
instructions, included here for the user's information: 


/C^SStTTt SYSU>! tUIUTSlKAp PALC-Vl 01/0a/75 PAGE 1 

/CASbEFTk vSYSTEN HCOTSTPAP 
/ COPYHIGHT 1 97P 

/ digital fcQDlP-ltNT corporation 

/ r-1 A Y N A P , M A S vS , O 1 7 5 ^ 

/ S , K , 

/STAKTxNG location (NOwMALLY): 4000 

/STAKYiNb LOCATION f-CJR 0S/«: Sill 


b 7 0 0 

kCLR=6700 

8 7 01 

KSORsb/Ol 

b7f;P 

K S E F' = 6 7 0 ? 

fc 7 V, ^ 

KSriF=6703 

b / v; 4 

KLSA=b704 

b7 0S 

KSAF=b70S 

b7 0b 

K {; 0 A s b 7 0 b 

6 7 0 7 

KRSBsb7/7 

700? 

e S w = 7 0 0 ? 

3 6 0 ? 

Lqc=ib0? 


0 4 00 0 

4 vj ii 0 

IP 37 

start , 

IFDEF 0 S 8 
*4000 
tad M 50 

0 4 0 0 1 

1 ? 01 b 

CRCCMK , 

tad L?b 0 

0 4 0 0 ? 

b 7 4 


KLSA 

0 4 0 0 3 

b 7 0 b 


KGU A 

04004 

b 7 C 3 


KSBF 

04005 

5 P 04 

ROCOD , 

JMP .-1 

0400 b 

/Pb 4 

L?b 0 , 

CML STa RAL 

0 4 0 0 7 

670 ? 


kSEN 

04 010 

7 b 1 0 


SKP CLA 

0401 1 

3 ?l 1 


DCA , 

0 4 0 1 ? 

3636 


DCA I PTR 

04013 

1?05 


TAD ROCOD 

04014 

6 7 04 


K LS A 


/P0P-8/&, -8/F, and -b/M ONLY 
/LOCATION where secondary 
/BOOTSTRAP really GETS LOADED 

<*3777;CLL> 

/initialize PULSE CLEARS THE LINK 
/CHANGE read CRC code (61 TO 
/REWIND <1> [BIN] 

/LOAD READ CRC CODE INTO STATUS 
/kEGISTER a [JMP I START] 

/fikst time through, link must 
/at 1 HERE 

/INITIATE the OPERATION (READ 
/CRC DR REWIND UR FRWD KIlE GAP) 
/READY? 

/ N 0 » WAIT 

/SET L*1 AND ACs A HALT (7776) 
/ANY ERRORS? 

/NO 

/halt ON ANY ERROR EXCEPT FOR 
/REWIND OR FRWD FILE GAP 
/CAN'T ALLOW 'TAD I PTR' LATER 
/TO AFFECT LINK 
/GET CODE FOR READ (0) 

/LOAD INTO status REGISTER A 
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04015 670h LOOP, KGOA /FIRST TIME STORES 173 INTO MEMORY 

/(fl-8IT compliment of RDCOD) 

/OTHER TIMES READS ONE 6-BIT 
/BYTE OF PAIR 


04016 

67 0 1 

KSOR 

/NEW DATA WORD REAOY? 


04017 

5216 

JMP .-1 

/NO, WAIT 


040a0 

7002 

HS w 

/move 6-bit byte to H,0. 

AC 

040?1 

7430 

SZL 

/WHICH 6-BIT BYTE DF THE 

PAIR? 

0 4 0 ? 2 

1636 

TAD 1 PTR 

/2ND, SO ADD IN 1ST BYTE 


04023 

7022 

CML HSw 

/SWAP BACK AGAIN, SET LINK TO 


/CASStTII- SYSTEl'-i fiflUTSTkAP PalC-VI 01/04/73 PAGE 1-1 

/INDICATE NEXT BYTE 


0 4 0 2 4 

3636 


DCA 

1 PTR 

/STORE BACK INTO MEMORY 

0 4 025 

7 4 2 r -i 


SNL 


/ARE wE DONE LOADING BOTH 6-81T 
/BYTES? 

0 4 02 6 

2 2 36 


isz 

PTR 

/YES, SO POINT TO NEXT MEMORY WORD 

0 4 Z 2 7 

223S 


ISZ 

KNT 

/BUMP COUNTER 

0 4 0 30 

5215 


JMP 

LOOP 

/REITERATE 

0 4 0 31 

7 346 


sta 

CLL RTL 


0 4 0 3 2 

7 0 0 2 


b s w 


/SET AC=757/ 

04033 

3235 


DC A 

KNT 

/SET COUNT TO ALLOW READING A 
/200 BYTE RECORD 

0 4 0 34 

5 2 0 1 


JMP 

CRCChk 

/GO CHECK The CRC 

0 40 35 

7 7 3 / 

K NT , 

7 737 


/ONES COMPLIMENT OF NUMBER OF 
/bytes to LOAD 

0 4 Oj 3 6 

355 7 

PTh , 

LOC- 

2 3 

/memory LOCATION TO BEGIN LOAD AT 

0 4 3 7 

7 7 30 

N 5 0 , 

-B0 


/CLA SPA SZL 


/iHjb KOUli^t BxNARY LUAuS binary files INTO MEMORY, 

/II nt^lNS BY LOADING A kECOHO OF SIZE 40, 

/Then Cn^jTiNuES TO LOAN SUCCESSIVE RECORDS EACH OF SIZE 

/f [''O. 

/This RPuCtSS continues until it destroys itself, 

/fLOuAIIONS 4000 AND 4001 ARE REPLACED BY JMP I (BIN] 

/By iHE StCONDARY BDOTSTkAP, 

/TkE FIkST vEMOkY location BEFORE A NEw CASSETTE RECORD 
/IS head In is LOAOEO with a RANDOM VALUE (173), 
/Si.CCFSSiVE nORDs ARc loaded WITH THE la-EIT QUANTITY, 
/U;0M + t3, whFRE A AND d ARE SUCCESSIVE b-B]T BYTES FROM 

/U'E cassette record, 

/ ^'E a;iI NGL EsS WORDS GET lUADED IF ThE CASSF.TTE CONTAINS 
bytes AvS can (And DUES) HAPPEN WHEN 'LOADING'* 

/ T H F H E A f} t H , AND w h E N 'LOADING' THE 0 R I G I *'l AT THE 
/ B t G i N N I ^.1 G OF The k E C 0 k D , 


•S 
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/CASSETTt SYSTEM bOUTST^AP 


PALC-Vl 


ai/04/73 


PAGE 1-a 


CPCCHK 

knT 

LDC 3b0a 
LOOP 4015 
La60 400b 
M50 4037 

PTR 403b 
RDCOO 4005 

start a000 
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C2BCX)T.BIN is the bootstrap which loads the Keyboard Monitor into 
memory. It is stored on the System Cassette and is comprised of the 
following instructions: 


/ ■it.coiNiO An y r s Afj •-'alc-vi page i 




/ bK'-ONDAKY t'OOTSrkAP 




/ 

COPYKlGHf 14/g 




/ 

uli^ITAL rQUlP'^t 

NT CORPORATION 



/ 

fiAY^ARu, MASb. 

0 1754 



/ 

S , W , 



? fli/ig 


bSwr 700g 



6 7 01 


kSijRsb 701 



6 7 !/l 1 


rv 3 10 P = b 7 0 1 



6 7^; 3 


KSbFsb7C-i3 



b 7 0 0 


«i.bA = b704 



b 7 y) 6 


K tj 0 A s 6 7 0 b 



b 7 7 


KRhb = 6 7 0 7 
f i 0 P U N C H 



3 b '.'i ? 


* 3 b 0 g 

Ei'JPlJ'^nh 



7 ? y 0 

b I N , 

S 1 A 


? 3 ^ j 3 

3 3 17 


IJ C A G R b T 


n 3 a 

1^33 

ITSPLH, 

fAu COF^i 


f 1 3 b n S 

3^30 


I'Ca bLU 


a 3 b w h 

3305 

n SOKG# 

OCA GRl, 

/ASSOMtS ORIGIN always APPEARS 
/AFTER FIEUO setting 

'hh-M 

7 ? 4 0 

b T N 1. u R , 

b T A 


b 1 0 

330 7 


1 ) C A il R G S 


0 5^11 

4 ? 4 3 


JMS GETbVT 


0 3 b 1 

7 0 0 g 

f- uOL » 

d S A' 


0 3 b 1 3 

7 1 1 g 


cll rtr 


3 3 6 14 

7 0 '5 0 


blL 


0 3 6 1 S 

5P35 


JMp SPEC 

/HIT 4=1 

0 3 b 1 b 

7 5 1 0 


SPA 

/dIT 4=0 (TWO WORO COMMAND) 

0 3 6 17 

g 3 0 7 


ISZ ORGSi-J 

/IS ORIGIN 

0 3 b g 0 

7 0 0 i.1 

N 7 0, 0 0 , 

nQP 


336gl 

7 0 04 


k Al 


0 3 6 2 g 

7 1 /j4 


CLL RAL 


0 3 6 g 3 

3 30b 


OCa TEb 


33r.ga 

4 g 0 3 


jMS GETdYT 


33og5 

1 3 0 b 


fAO TE0 

/COMblNE 

336gb 

a 30 7 


ISZ QRGSb 


0 3 6 g 7 

5 g 0 6 


JHP ITbORG 

/ORIGIN 

3 3 6 3 0 

7 4 0? 

FLD, 

HLT 


0 3 6 31 

3 7 05 


OCa I URG 


0 3 6 3 g 

g 305 


ISZ ORG 


'^633 

6g0l 

CD60» 

CUK M 


0 3 6 3 4 

5g07 


JMP blNLOR 


0363b 

7 50 0 

bPEC» 

3b A ' 


0 3 6 36 

530? 


JMP MON 


0 36 3 7 

7 00 6 


HTL 


0 3 64 0 

0gg0 


AND N700B 


0 36 4 1 

7 00g 


dS W 


0 3 6 0? 

5g0 4 


JMP itsflo 


0 3 6 4 3 

00 0 0 

GETHYT , 

0 


0 3 6 4 a 

g3l7 


ISZ &R6MT 


03605 

5g74 


JMR rdbyte 


0 3 6 o b 

1311 


TAD Xgb0 
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PaI.L’-V 1 


PAGE 1-1 


/ ^ rii r 1 u A S-- V K ‘Z I ri i g i' P m 


5 o 7 

1 s ' 


s 1. ;> A 

« ' s - h '.1 

P 7 1 K 


^ G u a 

.. s - ^ 1 

’•1 ^ > 


f. S ri r 

i> s - S ? 

Sr*^ 1 


Jf^P .-1 

: '■) > ■■' S S 

■5 ^ 


K H .S 4 

S’-~ 14 

V- 


A bli X 7 / f u 

■ o ^ ^ 

■/ n ,« 1 


•SZa cl a 

■ n 

/ ■; .■■. 0 


HL T 

. 3 B / 

<; 3 ’ 


i S Z r I K S T 

•; 3 ■' 

5 5mS 


.ln5 imOIEST 

1 

4 3 c 3 


RESET 

p ^ P P 

i:<ip 


f Ai) X 5 7 0 

■3 3 h < 

/ i 5 . * 


■stl 

■ ' 3 4 

^ M ^ 


JMp 1 X4bL5 

'■ S>'rlB 

1 <55 

NnTP>.-T, 

1 Ab x,7b0z.. 

■ 1 >1 n 

< < . 7 


(iCa 'jKMvT 

■ '1 3 *-1 4 f 

1 < 3 


1 A L ' X 5 id ' 0 

'-<<-/ ;.'i 

o f :■ 4 


^LS A 

,'1 S I 1 

n / ' A 


r\Gb A 

/ *s -f? 

•;> / ,■ 1 


S 1. ) E 

'"• :> ^ i 3 

T 5 ' P 


.-1 

/<■''/-» 

f 

h , ) y ip, 

t\ i; 0 A 

t ■ > : ’ / S 

A 7 ' 1 


- 3i 'E 

‘ ■ ^ ^ 7 ii 

5 P 7 P 


JMP .-1 

p 3 n ? ; 

5 '> 4 i> 


JMP I GETbYT 

f ' .*) 7 : ' (■'' 



/BLOCK 3V01,-. 




fjOP* 'NCei 

■’ S /'Jl 

■' 1 ; ' 


I'l 

cGPU'-.CE' 

i'3 1 s' -d 

A P 1 3 

MVy, 

COE Llr 10 

V/ 3 7 i, ’ 3 

5 / .■ ■ i 


J''^E 1 . + 1 

f ■ 3 7 3 a 

5 5'.'0 


52 bO 

»* 3 7 !■'' 3 

n 

u 4 G f 

0 

w3 i ii'-A' 

' •/' '/■ 0 

^y■^, 

O' 

^’3 ^ v' / 

.,■,■< 1 ! 

ij A G S ; ' , 

v) 

'.'3 7 1 U 

«.'5i' •■' 

X 5 U • 

5 0 b 

i' 5 7 11 

it< 5 o 

X 5h0 » 

5 so 


5^5 / 0 

X 5 7 , 

5 / 

1/'. 3 7 13 

7 7 3 7 

X V 7 3 / , 

/737 

0 3 7 14 

4 3 5 

X K ' v'T « 

4035 

037 1^ 

4 v' 3 ^ 

X 5 r R » 

<} li 3 

b 3 7 1 h 

4 I-' vi 5 

xa5 05., 

4 '0 l A ? 

037 1 7 

vV,' 1,'. 

G 5 ^ b i f 

b 

0 37,:’0 

/ 7 M 

X 7 7 74 , 

7 7 7 4 

U 3 7 P 3 

n n 

5 1 >■' S ) r 

-1 

3 7 P P 

/ A , j 0 

X 7 n 0 i ) » 

7b. lO 

0 3753 

0 3 j i/i 

K E ) E. ' f 

0 

3 7 54 

13 13 


T A b X 7 7 3 / 

03755 

3/14 


OCA I XKNT 


/lOCaTIOim 3701 IS SKIPPED BY 
/PPIMAkY udaoew 


/StT bp PftlMAPY BOOTSTRAP 
/PUR REUSE 
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/ SECONDARY BOOTSTRAP 


PaLC-V 1 


PAGE 1-2 


037Pb 

3715 


OCa 

I 

XPTW 

0^'37p7 

1332 


T AO 

X32U 

03730 

3735 


OCA 

1 

X401 1 

03731 

5/23 


JMP 

I 

RESET 

0 3 7 32 

3211 

X321 1 , 

3211 



0 3 7 3 3 

4 011 

X 4 0 1 i , 

401 1 



03734 

0 0 It ! 0 


ZtiLOCK 

400 0 - 

M 4 0 0 0 

3 5 0 2 


BlN 



04 001 

5 5 0 0 


JMP 

I 

.-1 


& 


/A "OCA KO=? LOCATION 4011 


/must tNO IN OCTAL 


/ .SECOND AtvY BUUTSIkAP 


PaLC- V 1 


page 1-3 


H 1 r.; 

3^02 


36 0/ 

C L) r 

3633 

F I R S T 

3/21 

FlO 

3^3'^ 

fool 

3d12 

Gr_l dYT 

36 4 3 

GK!< 1 

3/17 

I T S F L i; 

3 6 i/j 4 

ITSO^i, 

3 6 -1 b 

K S 1 ) F 

6 7 . '1 1 


3 7 0 2 

i.) T F S T 

3 h h 5 

‘ 1 7 L 0 

3H2'/ 

U K • 7 

3 /pd 

f) v !■; 

3 / 1 j 7 

R Ti F V T t 

i <4 

R r. S r, T 

< 7 2 5 

S P t C 

3 6 3 5 

T F 

i / i/j 6 

Y ^ M T 

3/14 

X. ! »« 

3 7 !•:> 

Y r' . ■ 

3 7 H’ 

X 2 F 

3 / n 

X 2 / 0 

3/12 

Y 3 2 1 1 

3 7 3 2 

y 4 0 ■/• 2 

3 7 1 6 

y 4 1 1 

3733 

y 7 ^ v'l 

3 V P ? 

V / / 3 7 

3/13 

X 7 / / 4 

3 7 2,1 
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APPENDIX F 

ASSEMBLY INSTRUCTIONS 


CAPS- 8 source programs are supplied on DECtape. Thesie sources are 
assembled with PALS and copied to cassette with PIPC, To build the 
CAPS-8 system cassette with PIPC, the user must load the OS/8 cassette 
handlers as described in USING AND LOADING YOUR NEW OS/8 CASSETTE 
HANDLERS (DEC-S8-UCASA-A-D) • The following instructions may be used 
to assemble the sources, print source listings, and create the CAPS-8 
system cassette on drive 0. 

.H PALtt 

*C2B00T^TEKH<C2B00T 
.H CHEF 

• TEMF 
.ri BAL8 

♦MON rOii> TEMP <CASM0N 
•R CHEF 

• TEMP 

• R PALti 

♦SYSCOP,TEMP<SYSCOP 

•ri CriEF 

♦TEM^ 

• ri PAL8 

*EDITC>TEMP<EDITC 

• ri CriEF 
♦TEMP 

• ri PAL8 

♦PA LC ^ TEMP <PA LC 

•ri CriEF 

• TEMP 

• ri PAL8 

♦CBAS I C ^ TEMP <CBAS I C / K 

• ri PIP 

• LPT :<TEMP^LS 

• H PIPC 
♦CSA0:</Z 

♦CSA0 :C2B00T<C2B00T/B 
♦CSAO :M0NT0ri<M0NT0ri/B 
♦CSA0 :SYSCOP<SYSCOP/B 
♦CiiA0 :EDI TC<EDITC/B 
♦CSA0 tPALC <PALC/B 
♦CSAO :CBASIC<CBASIC/B 
♦TTY :<CSA0 :/L 
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INDEX 


Addressing, BASIC, 6-51 
Alteration of text, 3-12 
ALTMODE Key, 

in BASIC, 6-52 
in Editor, 3-7 
AND, Boolean, 5-15 
Angle brackets, left/right (<>) 
Editor, 3-7 
PALC, 5-19 

ANORM subroutine, BASIC, 6-47 
Append command. Editor, 3-9 
Arithmetic operators, BASIC, 6-4 
Arithmetic statement, BASIC, 6-11 
Arrays, BASIC, 6-29 
maximum number, 6-28 
maximum size, 6-30 
ASCII character set, A-1 
ASCII format files, 2-1 
Assembler output, PALC, 5-32 
Assembly instructions, CAPS-8, F-1 
Autoindexing, PALC, 5-23 

BASIC language, 1-2, 6-1 
arithmetic statements, 6-1 
calling, 6-2 

editing and control commands, 6-52 

error messages, 6-57 

error message summary, B-6 

example run, 6-8 

floating point package, 6-50 

functions summary, B-10 

immediate mode, 6-6 

numbers, 6-2 

statements, 6-10 

statement summary, B-8 

symbol table, 6-59 

variables, 6-3 

BEGFIX subroutine, BASIC, 6-47 
Binary format files, 2-1 
Binary output, controlling PALC, 

5-28 

BKWD Statement, BASIC, 6-51 
Boolean AND, 5-15 
Boolean inclusive OR, 5-15 
Bootstraps, E-13 
BOOT PROGRAM, 9-1 
BOOT, 9-1 

Legal Mnemonics, 9-2 
Brackets , 

angle (<>) , 5-19 

square ( [ ] ) , 2-4 

BREAK command, BASIC, 

Calling 

BASIC, 6-1 
Editor, 4-1 
PALC, 5-1 
System Copy, 4-1 
CAPS-8 Cassette, see cassette 
Carriage return, 4-3 


Cassette 

directory listing, 2-1 
file, 1-4 
format, 1-4 
handler, E-6 
mnemonic code, PALC, C-3 
mounting/dismounting, 1-4, 1-5 
Cassette, BASIC, 6-1 
CHAIN statement, BASIC, 6-33 
Changing text. Editor, 3-12 
Characters , 

ASCII, A-1 
CTRL, 2-4 

Editor special, 3-4 
Monitor switch option, E-10 
PALC, 5-5 
PALC special, 5-17 
Character searches. Editor, 3-16 
Character string search. Editor, 

3-15, 3-17, 3-19 
CLOSE statement, BASIC, 6-15 
Coding formats, BASIC, 6-44 
Coding practices, PALC, 5-32 
CODT, 7-1 

additional techniques, 7-9 
commands, 7-2 to 7-8 
command summary, 7-11 
ERRORS, 7-9 
features, 7-1 
illegal characters, 7-8 
indirect references, 7-9 
interrupt program debugging, 7-9 
octal dump, 7-9 
operation and storage, 7-9 
programming dates, 7-10 
storage requirements, 7-10 
TTY I/O- FLAG, 7-9 
using, 7-2 
Colon ( : ) , 3-7 

Command format. Editor, 3-8 
Command mode. Editor, 3-4 
Commands 

BASIC, 6-6 
Editor summary, B-3 
keyboard monitor summary, B-1 
COMMA.S statement, BASIC, 6-20 
Comma used as format control 
character, 6-17 

Commenting the program, BASIC, 6-10 
Comments, PALC, 5-7 

Conditional assembly pseudo-operators 
PALC, 5-28 

Conditional delimiters, PALC, 5-19 
Conditional transfer, BASIC, 6-28, 
6-32 

Console terminal outjput, PALC, 5-2 
Control characters, BASIC, 6-17 
Control commands, BASIC, 6-52 
Controlling PALC binary output, 5-28 
Conventions of system, 2-1 
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Corrections, Keyboard Monitor, 2-3 
Creating run-time input files, 

BASIC, 6-25 
CTRL/C 

Editor, 4-3 
BASIC command, 6-54 
CTRL characters, 2-4 
CTRL keys. Editor, 3-5, 3-7 
CTRL/0 command, BASIC, 

Current line counter. Editor, 3-6 
Current location counter, PALC, 5-10 

DATA statement, BASIC, 6-12 

DAte command, 2-7 

DECIMAL pseudo-op, PALC, 5-24 

Default device, PALC, 5-2 

DEF statement, BASIC, 6-43 

DElete command. Keyboard Monitor, 2-8 

Deletion of page. Editor, 3-14 

Deletion of text, 3-12, 3-13 

Delimiters, PALC conditional, 5-11 

Delimiting character, PALC, 5-6 

Device, default, PALC, 5-2 

Device handlers, 2-11 

Devices, I/O, 2-2 

DIM statement, BASIC, 6-30 

Direct assignment statement, PALC, 

5- 12 

Directory command, 2-7 
options, 2-8 

Directory of system cassette, 2-1 
Dismounting a cassette, 1-5 

Editing and control commands, BASIC, 

6- 52 
Editor 

calling, 3-1 

character searches, 3-16 
commands, 3-8, 3-12 
command summary, B-3 
demonstration run, 3-23 
error messages, 3-21, 3-22 
error message summary, B-2 
operating modes, 3-4 
text collection, 3-15 
EJECT pseudo-op, PALC, 5-30 
End of file, PALC, 5-26 
End of pass, PALC, 5-19 
END statement, BASIC, 6-11 
ENPUNCH pseudo-op, PALC, 5-28 
Entering text strings, PALC, 5-27 
Equal sign (=) 

BASIC, 6-6 
Editor, 3-7 

Erase (CTRL/U) , Editor, 3-5 
Erasing a program in memory, BASIC, 
6-5 5 

Errors, Keyboard Monitor loading, 2-3 
Errors in Programming, BASIC, 6-59 
Error recovery. Editor, 3-5 
Error Messages, 

BASIC, 6-57 
summary, B-6 


Editor, 3-21, 3-22 
summary, B-2 
Keyboard Monitor, 2-12 
summary, B-1 
PALC, 5-34 
summary, B-5 
System copy, 4-3 
summary, B-4 
E-type notation, 6-2 
Example programs, BASIC, 6-8 
Expansion of text. Editor, 3-12 
Exponential format, 6-2 
Expressions, PALC, 5-14 
EXPUNGE pseudo-op, PALC, 5-29 
Extended memory, PALC, 5-27 
Extensions of filenames, 2-2 

FAC function, BASIC, 6-47 
FENTER statement, BASIC, 6-45 
FEXT statement, BASIC, 6-45 
FIELD pseudo-op, PALC, 5-25 
Field of nesting loops, 6-28 
File formats, 2-1 
File gap, 1-4 
File header record, 1-4 
Filenames, 2-2 

Files, multiple input. Editor, 3-2 
Files, transferring individual. 
System Copy, 4-1 
File types, E-11 
FIX subroutine', BASIC, 6-4 7 
FIXMRI pseudo-op, PALC, 5-29 
FIXTAB pseudo-op, PALC, 5-29 
Floating-Point format, 6-46 
normalized, 6-47 

Floating-point package, 6-45, 6-50 
FNA function, BASIC, 6-43 
Form Feed 
Editor, 3-5 
PALC, 5-7 

format control characters, BASIC, 
6-17 

Formats for BASIC numbers, 6-2 
Formats of files, 2-1 
FOR-NEXT loop, BASIC, 6-27 
exiting from, 6-28 
FOR statement, BASIC, 6-27 
Function addresses, BASIC, 6-45 
Function control word, E-6 
Functions. 

BASIC, 6-37 
summary, B-10 
Editor, 3-4 

user coded BASIC, 6-44 
FWD statement, BASIC, 6-51 

GET function, BASIC, 6*-41 
Getting on-line, 2-1 
GOSUB nesting, maximum level, 6-37 
GOSUB statement, BASIC, 6-35 
GOTO statement, BASIC, 6-3,2 
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Hardware bootstrap (MI8-E) , 1-1 
Hardware componentsf, 1-2, 

IFDEF pseudo-op, PALC, 5-28 
IF END# statement, BASIC, 6-34 
IF GOTO statement, BASIC, 6-32 
IFNDEF pseudo-op, PALC , 5-28 
IFNZRO pseudo-op, PALC, 5-28 
IF THEN statement, BASIC, 6-32 
IFZERO pseudo-op, PALC, 5-28 
Illegal symbolic addresses, PALC, 
5-10 

Immediate mode, BASIC, 6-6 
Implementing a user-coded function, 
BASIC, 6-44 

Incorporating subroutines with UUF, 
BASIC, 6-46 

Incremental value, BASIC, 6-27 
Index in FOR statement, BASIC, 6-27 
Indirect addressing, PALC, 5-20, 

5- 24 

Initial value in FOR statement, 
BASIC, 6-27 

Input commands , Editor , 3-9 
Input file extensions, PALC, 5-1 
Input files, creation of, BASIC, 

6- 25 

Input specifications. 

Editor, 3-2 
PALC, 5-1 
System Copy, 4-2 
INPUT statement, BASIC, 6-14 
INPUT# statement, BASIC, 6-16 
Input/output devicejs , 2-2 
Input/output statements, 6-12 
Input/output transfer micro- 
instructions, PALC, 5-2 3 
Insert command. Editor, 3-14 
Instructions, PALC, 5-6, 5-30 
Instruction set, BASIC, 6-50 
Interactive programming language , 
BASIC, 6-1 

Integer niimber format, BASIC, 6-2 
Inter-buffer character string 
search. Editor, 3-19 
Internal format, BASIC, 6-44 
Internal symbol representation 
for PALC, 5-13 

Ihtra-buffer character string 
search. Editor, 3-17 
INT function, BASIC, 6-38 
INT(x), integer function, BASIC, 

6-3 8 

I/O designations, 2-5 

lOT microinstructions, PALC, C-2 

Keyboard monitor, 1-1, 1-2 
commands, 2-5 
command summary, B-1 
error messages, 2-12, B-1 
loading and using, 2-3 
memory map, E-1 
services, E-1 


Keyboard reader mnemonic code, 

PALC, C-3 

Keys, special Editor, 3-5, 3-6, 

3-7 

Labels, PALC, 5-6 

Language, interactive programming, 
(BASIC) , 6-1 

Leader-trailer tape , 1-3 
Left angle bracket (<) , Editor, 3-7 
LET command, BASIC, 6-7 
LET statement, BASIC, 6-11 
Levels of nesting, maximum, 6-29 
LINE FEED key. Editor, 3-6 
Line printer listing. Editor, 3-11 
Line Printer mnemonic code, PALC, 

C-3 

Line printer output, PALC, 5-3 
Link generation and storage, PALC, 
5-30 

LIST and LPT command, BASIC, 6-54 
LIST command, BASIC, 6-53 
List commands. Editor, 3-10 
Listing a program, BASIC, 6-53 
List of arrays, BASIC, 6-28 
Literals, assigning PALC, 5-18 
Load command, 2-7 
Loading keyboard monitor, 2-3 
Local symbolic addresses, PALC, 5-9 
Loops, 6-27 

LPT and RUN commands, BASIC, 6-54 
LPT statement, BASIC, 6-21 

Matrices, BASIC, 6-29 
Maximum level of GOSUB nesting, 
BASIC, 6-37 

Memory extension control, PALC, C-4 

Memory map. Monitor, E-1 

Memory reference instructions , PALC , 

5- 2 0, C-1 

Microinstructions, PALC, 5-21, C-1, 
C-2 

MI8--E hardware bootstrap, 1-1 
Monitor, see Keyboard Monitor 
Mounting a cassette, 1-5 
Move text. Editor, 3-15 
MQ microinstructions, C-2 
Multiple files, 2-6, 2-7 
Editor input, 3-2 

Multiple input cassettes, PALC, 5-3 
Multiple statements, BASIC, 6-10 
Multistatement lines, PALC 5-8 

NAMIS command, BASIC, 6-56 
Nested parentneses, BASIC 6-5 
Nesting, level of GOSUB, BASIC, 

6- 3 7 

Nesting, Levels of, 6-28, 

Nesting loops, 6-2 £ 

Nesting procedures, 6-28 
Nes ting subroutines , 6-3 6 
NEW statement, BASIC, 6-2 
NEXT statement, BASIC, 6-27 
NO COMMAS statement., BASIC, 6-20 
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NOPUNCH pseudo-op, PALC, 5-28 
Normalized Floating-Point format, 
BASIC, 6-47 

NO RUBOUTS command, BASIC, 6-52 
Numbers 

in BASIC, 6-2 
in PALC, 5-9 

of statements, BASIC, 6-10 
Numbers, version, 3-3 

Octal pseudo-op, PALC, 5-24 
OLD statement, BASIC, 6-2 
OPEN statement, BASIC, 6-15 
Operands, PALC, 5-7 
Operate microinstructions, PALC, 
5-21, 5-22, C-1, C-2 
Operating modes. Editor, 3-4 
Operators , 

BASIC arithmetic, 6-4 
PALC, 5-14, 5-15 
relational, 6-11 
Options, PALC, 5-5 
OR, Boolean inclusive, 5-15 
Order of execution of BASIC state- 
ments, 6-10 

Output commands. Editor, 3-10 
Output file extensions, PALC, 5-2 
Output file. Editor, 3-3 
Output specifications 
Editor, 3-2 
PALC, 5-2 
System Copy, 4-2 

Page deletion, 3-14 
Page format, PALC, 5-29 
PAGE n pseudo-op, PALC, 5-26 
Page zero addressing, PALC, 5-24 
PALC (Program Assembly Language for 
Cassette) , 1-2 
assembler output, 5-32 
calling, 5-1 
coding practices, 5-31 
character set, 5-5 
delimiting character, 5-6 
error codes and conditions, 5-33, 
5-34 

error message summary, B-5 
foirmat effectors, 5-7 
instructions, 5-20 
link generation and storage, 5-30 
numbers, 5-9 
options, 5-5 

permanent symbol table, C-1 
program preparation, 5-32 
pseudo-operators, 5-24 
statements. 5-6 
symbols, 5-9 


Parentheses in 

BASIC, 6-5 

Pass 1, 

PALC, 

5-1, 5-3 

Pass 2, 

PALC, 

5-1, 5-3 

Pass 3, 

PALC, 

5-4 


PAUSE pseudo-op, PALC, 5-26 
Permanent symbols, PALC, 5-9 
Permanent symbol table, altering 
PALC, 5-29 

PRINT command, BASIC, 6-6 
Print positions, BASIC, 6-40 
PRINT statement, BASIC, 6-16 
PRINT# statement, BASIC, 6-20 
Print zones, 6-17 
Priority of operations, BASIC 
arithmetic, 6-4 

Programming errors, BASIC, 6-59 
Program Assembly Language for 
Cassette, see PALC 
Program chaining, BASIC, 6-34 
Program preparation, PALC, 5-32 
Program storage, BASIC, 6-1 
Pseudo operators, PALC, 5-24 
summary, C-4 

PUT function, BASIC, 6-42 

Radix control, PALC, 5-24 
Read command. Editor, 3-10 
Reader record file structure, E-11 
READ statement, BASIC, 6-12 
Real format, BASIC, 6-2 
Record, file header, 1-4 
Relational operators, BASIC, 6-11 
Relative addressing, BASIC, 6-51 
REMARK statement, BASIC, 6-10 
Renaming a program, BASIC, 6-56 
RETURN key. Editor, 3-5 
RETURN statement, BASIC, 6-35 
Return to command mode. Editor, 3-5 
Reserving memory, PALC, 5-27 
Resetting location counter, PALC, 

5- 26 

RESTORE statement, BASIC, 6-13 
Rewind button, 1-6 
REwind command, 2-10 

Right angle bracket (>) , Editor, 3-7 

Ring buffers, E-10 

RND(x) function, BASIC, 6-39 

RUBOUT command, BASIC, 6-52 

Rubout key, 2-3, 3-5 

Run command, 2-6 

RUN command, BASIC, 6-54 

Running a BASIC program, 6-54 

Run-time input file creation, BASIC, 

6- 2 5 

Run-time output files, BASIC, 6-15 


SAVE command, BASIC, 6-56 
Saving a program, BASIC, 6-56 
SCRATCH command, BASIC, 6-55 
Search for character. Editor, 3-16 
Search for character string. Editor, 
3-13, 3-15, 3-17, 3-19 
Semicolon used as BASIC format control 
character, 6-17 
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Sentinel file, 1-4 
Service utility subroutines. 

Monitor, E-1 

SGN (x) function, BASIC, 6-38 
SHIFT/0 command, BASIC, 6-52 
Single character search. Editor, 3-16 
Sign bit, BASIC, 6-46 
Skip command. Editor, 3-15 
Slash (/) symbol. Editor, 3-6 
Software components, 1-2 
Spaces, BASIC, 6-5 
Special characters, PALC, 5-17 
Specification options, 2-5 
Square brackets ( [] ) , 2-4 
Statement numbers, BASIC, 6-10 
Statement summary, BASIC, B-8 
Statements, PALC, 5-6 
direct assignment, 5-12 
Statement terminators, PALC, 5-7 
STEP value, BASIC, 6-27 
Stopping a run, BASIC, 6-54 
STOP statement, BASIC, 6-11 
String search termination. Editor, 
3-20 

Subroutines, Monitor service 
utility, E-1 

Subroutines, BASIC, 6-35 
Subscripted variables, BASIC, 6-29 
Subscripts, BASIC, 6-30 
Suppress listing, PALC, 5-27 
Switch option characters, E-10 
Symbolic addresses illegal in 
PALC, 5-10 

Symbolic Editor, 1-2, 3-1 
symbolic instructions, PALC, 5-13 
Symbolic operands, PALC, 5-13 
Symbols, PALC, 5-9 
Symbol table, 

BASIC, 6-59 
PALC, 5-11 

Syntax error. Editor, 3-22 
System cassette, 1-4 
directory, 2-1 
System conventions, 2-1 
System Copy (SYSCOP) , 1-2 
calling, 4-2 
error messages, 4-4 
error message summary, B-4 
example, 4-3 
options, 4-2 

System demonstration run, D-1 
System programs, 2-1 


TAB function, BASIC, 6-40 
Tabulation (CTRL/TAB] , Editor, 3-7 
Tabulations, PALC, 5--7 
Teleprinter/Punch mnejmonic code , 

PALC, C-3 

Terminal value in BASIC loop, 6-27 
Terminating assembly, PALC, 5-34 
Terminating string search. Editor, 
3-20 

Terminating the BASIC program, 6-11 
Text collection. Editor, 3-15 
Text mode. Editor, 3-4 
TEXT pseudo -op, PALC, 5-27 
Text transfer commands. Editor, 3-11 
Transfer of control statements, BASIC 
6-31 

Transferring individual files. 

System Copy, 4-1 

Transition between modes. Editor, 3-4 
TTY OUT statement, BASIC, 6-22 
TU60 dual cassette unit, 1-5 

Unconditional transfeir, BASIC, 6-3 2 
Underlining in examples, 1-6 
User-coded functions , examples of 
BASIC, 6-47 

User-defined symbols, PALC, 5-9 
Using cassette, BASIC, 6-1 
Utility codes, E-9 
UTILITY PROGRAM, 8-1 

error messages, 8-2, 8-3 
options, 8-1 
UTIL, 8-1 

Variables, BASIC, 6-3 
subscripted, 6-29 
Version command, 2-10 
Version numbers. Editor, 3-3 

Write protect tabs, 1-3 
Writing the program, BASIC, 6-47 

XLIST pseudo-op, PALC, 5-27 

Zero command. Keyboard Monitor, 2-9 
Zeroing output file, 4-2 
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□ Higher-level language programmer 
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I I User with little programming experience 
I I Student programmer 

□ Non-programmer interested in computer concepts and capabilities 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS, MAILING LIST 


The Software Communications Group# located at corporate headquarters in 
Maynard# publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly# 
and contain announcements of new and revised software# programming 
notes# software problems and solutions# and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system# and are published periodi- 
cally. For information on the distribution of these docujnents and how 
to get on the software newsletter mailing list# write to: 

Software Communiccitions 

P. O. Box F 

Maynard# Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital "s software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe# software problem 
reporting centers are in the following cities. 


Reading# England 
Paris# France 
The Hague# Holland 
Tel Aviv# Israel 


Milan# Italy 
Solna# Sweden 
Geneva# Switzerland 
Munich# West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States# send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard# Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View# California 94043 


Outside of the United States# orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS# Digital Equipment Computer Users Society# maintains a user ex- 
change center for user-written programs and technical application in- 
formation. A catalog of existing programs is available. The society 
publishes a periodical# DECUSCOPE# and holds technical seminars in the 
United States# Canada# Europe# and Australia. For information on the 
society and membership application forms# write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment, S.A. 
81 Route de I'Aire 
1211 Geneva 26 
Switzerland 



